Supporto di PowerShell per cluster gateway dati locali

  • Articolo

Gli script di PowerShell sono disponibili nella raccolta di PowerShell. Gli script descritti in questo articolo sono per PowerShell versione 5. Quando si usa PowerShell versione 7, vedere Cmdlet di PowerShell per la gestione del gateway dati locale. È possibile usare gli script di PowerShell per eseguire le operazioni seguenti:

  • Recuperare l'elenco dei cluster gateway disponibili per un utente.
  • Recuperare l'elenco delle istanze del gateway registrate in un cluster e il relativo stato online o offline.
  • Modificare lo stato di abilitazione o disabilitazione per un'istanza del gateway all'interno di un cluster e di altre proprietà del gateway.
  • Eliminare un gateway.

Eseguire i comandi di PowerShell

Per installare questi cmdlet, eseguire il comando seguente in una sessione di PowerShell con privilegi elevati:

Install-Module -Name OnPremisesDataGatewayHAMgmt

L'intero elenco di cmdlet è disponibile usando il comando seguente:

Get-Command -Module OnPremisesDataGateway*

Esempi e descrizioni sono inclusi nei cmdlet ed è possibile accedervi usando il comando seguente:

get-help <cmdlet-name>

È ora possibile usare i comandi nella tabella seguente per gestire i cluster gateway.

Comando Descrizione Parametri
Login-OnPremisesDataGateway Usare questo comando per accedere per gestire i cluster del gateway dati locale. È necessario eseguire questo comando e accedere prima che altri comandi a disponibilità elevata funzionino correttamente. Nota: il token di autenticazione di Microsoft Entra ID acquisito come parte di una login chiamata è valido solo per un'ora, dopo la quale scade. È possibile eseguire di nuovo il login comando per acquisire un nuovo token. Nome utente e password dell'ID Microsoft Entra (fornito come parte dell'esecuzione del comando, non chiamata iniziale).
Get-OnPremisesDataGatewayClusters Recupera l'elenco dei cluster gateway per l'utente connesso. Facoltativamente, è possibile passare parametri di formattazione a questo comando per migliorare la leggibilità, ad esempio Format-Table -AutoSize -Wrap.
Get-OnPremisesDataClusterGateways Recupera l'elenco dei gateway all'interno del cluster specificato e informazioni aggiuntive per ogni gateway, ad esempio lo stato online o offline e il nome del computer. -ClusterObjectID xyz (dove xyz viene sostituito con un valore effettivo di ID oggetto cluster, che può essere recuperato usando il comando Get-OnPremisesDataGatewayClusters ).
Set-OnPremisesDataGateway Usare questo comando per impostare i valori delle proprietà per un determinato gateway all'interno di un cluster, che include la possibilità di abilitare o disabilitare un'istanza del gateway specifica. -ClusterObjectID xyz (dove xyz viene sostituito con un valore effettivo di ID oggetto cluster, che può essere recuperato usando il comando Get-OnPremisesDataGatewayClusters ). -GatewayObjectID abc (dove abc viene sostituito con un valore id oggetto gateway effettivo, che può essere recuperato usando il comando Get-OnPremisesDataClusterGateways, dato un ID oggetto cluster).
Get-OnPremisesDataGatewayStatus Usare questo comando per recuperare lo stato per una determinata istanza del gateway all'interno di un cluster. -ClusterObjectID xyz (dove xyz viene sostituito con un valore effettivo di ID oggetto cluster, che può essere recuperato usando il comando Get-OnPremisesDataGatewayClusters ). -GatewayObjectID abc (dove abc viene sostituito con un valore id oggetto gateway effettivo, che può essere recuperato usando il comando Get-OnPremisesDataClusterGateways, dato un ID oggetto cluster).
Remove-OnPremisesDataGateway Usare questo comando per rimuovere un'istanza del gateway da un cluster. Nota: il gateway primario nel cluster non può essere rimosso finché non vengono rimossi tutti gli altri gateway nel cluster. -ClusterObjectID xyz (dove xyz viene sostituito con un valore effettivo di ID oggetto cluster, che può essere recuperato usando il comando Get-OnPremisesDataGatewayClusters ). -GatewayObjectID abc (dove abc viene sostituito con un valore id oggetto gateway effettivo, che può essere recuperato usando il comando Get-OnPremisesDataClusterGateways, dato un ID oggetto cluster).

Passaggi successivi