Compartilhar via


Update-DataGatewayClusterMember

Inicie uma atualização quando uma versão mais nova estiver disponível ou verifique o status da última atualização no membro do gateway especificado no cluster.

Para usar este cmdlet, sua versão gateway deve ser (novembro de 2025) ou superior.

Sintaxe

Default (Default)

Update-DataGatewayClusterMember
    -GatewayClusterId <Guid>
    [-MemberGatewayId <Guid>]
    [-CheckStatus]
    [-TargetVersion <Version>]
    [<CommonParameters>]

Description

Inicie uma atualização quando uma versão mais recente estiver disponível ou verifique o status da última atualização no membro do gateway especificado no cluster

Exemplos

Exemplo 1

PS C:\> Update-DataGatewayClusterMember -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77

GatewayObjectId                      GatewayVersion  Status
---------------                      --------------  ------
DC8F2C49-5731-4B27-966B-3DB5094C2E77 3000.262.13    Acknowledged

Iniciar a atualização para a versão mais recente no gateway primário no ID do cluster 64C574B7-86C6-4560-B710-40AC18990804

Exemplo 2

PS C:\> Update-DataGatewayClusterMember -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77 -MemberGatewayId 64C574B7-86C6-4560-B710-40AC18990804 -TargetVersion 3000.294.7

GatewayObjectId                      GatewayVersion  Status
---------------                      --------------  ------
64C574B7-86C6-4560-B710-40AC18990804 3000.262.13    Acknowledged

Iniciar a atualização para a versão 3000.294.7 no ID de membro do gateway especificado 64C574B7-86C6-4560-B710-40AC18990804 no ID do cluster do gateway DC8F2C49-5731-4B27-966B-3DB5094C2E77

Exemplo 3

PS C:\> Update-DataGatewayClusterMember -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77 -CheckStatus

GatewayObjectId                      GatewayVersion  Status
---------------                      --------------  ------
DC8F2C49-5731-4B27-966B-3DB5094C2E77 3000.262.13    InProgress

Obtenha o status da última atualização do gateway primário no ID do cluster 64C574B7-86C6-4560-B710-40AC18990804

Parâmetros

-CheckStatus

Indica para verificar apenas o status da última atualização e não iniciar a operação de atualização.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-GatewayClusterId

O ID do cluster de gateway que tem a atualização do Gateway. Tem que ser um cluster de gateway existente no mesmo tenant.

Propriedades do parâmetro

Tipo:Guid
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:Cluster, ID

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-MemberGatewayId

Este é o ID do gateway para atualizar. Tem que ser um gateway existente no cluster.

Propriedades do parâmetro

Tipo:Guid
Valor padrão:GatewayClusterId
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-TargetVersion

A versão alvo para atualizar. Para obter a lista de versões suportadas, execute o comando Get-DataGatewayAvailableUpdates

Propriedades do parâmetro

Tipo:Version
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

None

Saídas

Microsoft.PowerBI.DataMovement.ExternalContracts.API.OnPremGatewayUpdateResponse