PowerShell-Support für lokale Datengatewaycluster

  • Artikel

PowerShell-Skripte finden Sie im PowerShell-Katalog. Die in diesem Artikel beschriebenen Skripts gelten für PowerShell Version 5. Wenn Sie PowerShell Version 7 verwenden, finden Sie weitere Informationen unter PowerShell-Cmdlets für die Verwaltung lokaler Datengateways. Mit den PowerShell-Skripts können Sie die folgenden Vorgänge ausführen:

  • Abrufen einer Liste der für Benutzer verfügbaren Gatewaycluster.
  • Abrufen einer Liste der in einem Cluster registrierten Gatewayinstanzen und deren Status (online oder offline).
  • Ändern des Aktivierungs- oder Deaktivierungsstatus für eine Gatewayinstanz in einem Cluster und Ändern anderer Gatewayeigenschaften.
  • Löschen eines Gateways.

Ausführen der PowerShell-Befehle

Führen Sie zum Installieren dieser Cmdlets den folgenden Befehl in einer PowerShell-Sitzung mit erweiterten Rechten aus:

Install-Module -Name OnPremisesDataGatewayHAMgmt

Die gesamte Liste der Cmdlets kann mit dem folgenden Befehl abgerufen werden:

Get-Command -Module OnPremisesDataGateway*

Beispiele und Beschreibungen sind in den Cmdlets enthalten, auf die Sie mit dem folgenden Befehl zugreifen können:

get-help <cmdlet-name>

Jetzt können Sie die Befehle in der folgenden Tabelle verwenden, um Gatewaycluster zu verwalten.

Befehl Beschreibung Parameter
Login-OnPremisesDataGateway Verwenden Sie diesen Befehl, um sich anzumelden und Ihre lokalen Datengatewaycluster zu verwalten. Sie müssen diesen Befehl ausführen und sich anmelden, bevor andere Hochverfügbarkeitsbefehle ordnungsgemäß funktionieren können. Hinweis: Das Microsoft Entra ID-Authentifizierungstoken, das beim login-Aufruf abgerufen wird, ist nur eine Stunde lang gültig und läuft dann ab. Sie können den login-Befehl erneut ausführen, um ein neues Token zu erhalten. Microsoft Entra ID-Benutzername und -Kennwort (bei der Ausführung des Befehls bereitgestellt, nicht beim ersten Aufruf)
Get-OnPremisesDataGatewayClusters Ruft die Liste der Gatewaycluster für den angemeldeten Benutzer ab. Optional können Sie zur besseren Lesbarkeit Formatierungsparameter an diesen Befehl übergeben, z. B. Format-Table -AutoSize -Wrap.
Get-OnPremisesDataClusterGateways Ruft die Liste der Gateways im angegebenen Cluster und zusätzliche Informationen zu jedem Gateway ab (Status (online oder offline) und Computername). -ClusterObjectID xyz (wobei xyz durch einen tatsächlichen Wert für eine Clusterobjekt-ID ersetzt wird, der mit dem Befehl Get-OnPremisesDataGatewayClusters abgerufen werden kann).
Set-OnPremisesDataGateway Verwenden Sie diesen Befehl, um Eigenschaftswerte für ein bestimmtes Gateway innerhalb eines Clusters festzulegen, einschließlich der Möglichkeit, eine bestimmte Gatewayinstanz zu aktivieren oder zu deaktivieren. -ClusterObjectID xyz (wobei xyz durch einen tatsächlichen Wert für eine Clusterobjekt-ID ersetzt wird, der mit dem Befehl Get-OnPremisesDataGatewayClusters abgerufen werden kann). -GatewayObjectID abc (wobei abc durch einen tatsächlichen Wert für eine Gatewayobjekt-ID ersetzt wird, der mit dem Befehl Get-OnPremisesDataClusterGateways abgerufen werden kann, wenn eine Clusterobjekt-ID vorhanden ist).
Get-OnPremisesDataGatewayStatus Verwenden Sie diesen Befehl, um den Status einer bestimmten Gatewayinstanz innerhalb eines Clusters abzurufen. -ClusterObjectID xyz (wobei xyz durch einen tatsächlichen Wert für eine Clusterobjekt-ID ersetzt wird, der mit dem Befehl Get-OnPremisesDataGatewayClusters abgerufen werden kann). -GatewayObjectID abc (wobei abc durch einen tatsächlichen Wert für eine Gatewayobjekt-ID ersetzt wird, der mit dem Befehl Get-OnPremisesDataClusterGateways abgerufen werden kann, wenn eine Clusterobjekt-ID vorhanden ist).
Remove-OnPremisesDataGateway Verwenden Sie diesen Befehl, um eine Gatewayinstanz aus einem Cluster zu entfernen. Hinweis: Das primäre Gateway im Cluster kann erst entfernt werden, wenn alle anderen Gateways aus dem Cluster entfernt wurden. -ClusterObjectID xyz (wobei xyz durch einen tatsächlichen Wert für eine Clusterobjekt-ID ersetzt wird, der mit dem Befehl Get-OnPremisesDataGatewayClusters abgerufen werden kann). -GatewayObjectID abc (wobei abc durch einen tatsächlichen Wert für eine Gatewayobjekt-ID ersetzt wird, der mit dem Befehl Get-OnPremisesDataClusterGateways abgerufen werden kann, wenn eine Clusterobjekt-ID vorhanden ist).

Nächste Schritte