Update-DataGatewayClusterMember

Inicia una actualización cuando haya una versión más reciente disponible o revisa el estado de la última actualización en el miembro especificado del gateway en el clúster.

Para usar este cmdlet, tu versión de gateway debe ser (noviembre de 2025) o superior.

Sintaxis

Default (valor predeterminado)

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

Description

Inicia una actualización cuando haya una versión más reciente disponible o revisa el estado de la última actualización en el miembro especificado del gateway en el clúster

Ejemplos

Ejemplo 1

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

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

Iniciar la actualización a la última versión en la pasarela principal en el ID del clúster 64C574B7-86C6-4560-B710-40AC18990804

Ejemplo 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

Inicia la actualización a la versión 3000.294.7 en el ID de miembro de la pasarela especificado 64C574B7-86C6-4560-B710-40AC18990804 en el ID del clúster de la pasarela DC8F2C49-5731-4B27-966B-3DB5094C2E77

Ejemplo 3

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

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

Obtén el estado de última actualización de la pasarela principal en el ID del clúster 64C574B7-86C6-4560-B710-40AC18990804

Parámetros

-CheckStatus

Indica que solo hay que comprobar el estado de la última actualización y no iniciar la operación.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-GatewayClusterId

El ID del clúster de gateway que tiene la actualización de Gateway. Tiene que ser un clúster de gateway existente en el mismo tenant.

Propiedades de parámetro

Tipo:Guid
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Clúster, Id

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-MemberGatewayId

Este es el ID del gateway para actualizar. Tiene que ser una pasarela existente en el clúster.

Propiedades de parámetro

Tipo:Guid
Valor predeterminado:GatewayClusterId
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-TargetVersion

La versión de destino a la que actualizar. Para obtener la lista de versiones soportadas, ejecuta el comando Get-DataGatewayAvailableUpdates

Propiedades de parámetro

Tipo:Version
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

None

Salidas

Microsoft.PowerBI.DataMovement.ExternalContracts.API.OnPremGatewayUpdateResponse