Condividi tramite


Update-DataGatewayClusterMember

Avvia un aggiornamento quando è disponibile una versione più recente o controlla lo stato dell'ultimo aggiornamento sul membro gateway specificato nel cluster.

Per usare questo cmdlet, la versione del tuo gateway deve essere (novembre 2025) o superiore.

Sintassi

Default (Impostazione predefinita)

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

Descrizione

Avvia un aggiornamento quando è disponibile una versione più recente o controlla lo stato dell'ultimo aggiornamento sul membro gateway specificato nel cluster

Esempio

Esempio 1

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

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

Avvia l'aggiornamento all'ultima versione sul gateway principale nel cluster ID 64C574B7-86C6-4560-B710-40AC18990804

Esempio 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

Avvia l'aggiornamento alla versione 3000.294.7 sull'ID membro gateway specificato 64C574B7-86C6-4560-B710-40AC18990804 nell'ID cluster gateway DC8F2C49-5731-4B27-966B-3DB5094C2E77

Esempio 3

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

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

Ottieni lo stato dell'ultimo aggiornamento per il gateway principale nell'ID cluster 64C574B7-86C6-4560-B710-40AC18990804

Parametri

-CheckStatus

Indica di controllare solo lo stato dell'ultimo aggiornamento e di non avviare l'operazione di aggiornamento.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-GatewayClusterId

L'ID del cluster gateway che ha l'aggiornamento del Gateway. Deve essere un cluster gateway esistente sullo stesso tenant.

Proprietà dei parametri

Tipo:Guid
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Cluster, id

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-MemberGatewayId

Questo è l'ID del gateway da aggiornare. Deve essere un gateway esistente nel cluster.

Proprietà dei parametri

Tipo:Guid
Valore predefinito:GatewayClusterId
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-TargetVersion

La versione target a cui aggiornare. Per ottenere l'elenco delle versioni supportate, esegui il comando Get-DataGatewayAvailableUpdates

Proprietà dei parametri

Tipo:Version
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

None

Output

Microsoft.PowerBI.DataMovement.ExternalContracts.API.OnPremGatewayUpdateResponse