Freigeben über

PowerShell-Unterstützung für lokale Datengatewaycluster

PowerShell-Skripts sind im PowerShell-Katalog verfügbar. Die in diesem Artikel beschriebenen Skripts gelten für PowerShell Version 5. Wenn Sie PowerShell Version 7 verwenden, verweisen Sie auf PowerShell-Cmdlets für die Verwaltung des lokalen Datengateways. Sie können die PowerShell-Skripts verwenden, um die folgenden Vorgänge auszuführen:

  • Rufen Sie die Liste der Gatewaycluster ab, die für einen Benutzer verfügbar sind.
  • Rufen Sie die Liste der Gatewayinstanzen ab, die in einem Cluster registriert sind, und deren Online- oder Offlinestatus.
  • Ändern Sie den Status "Aktivieren oder Deaktivieren" für eine Gatewayinstanz innerhalb eines Clusters und 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 erhöhten Rechten aus:

Install-Module -Name OnPremisesDataGatewayHAMgmt

Die gesamte Liste der Cmdlets finden Sie mit dem folgenden Befehl:

Get-Command -Module OnPremisesDataGateway*

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

get-help <cmdlet-name>

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

Befehl Beschreibung Parameter
Login-OnPremisesDataGateway Verwenden Sie diesen Befehl, um sich anzumelden, um Ihre lokalen Datengatewaycluster zu verwalten. Sie müssen diesen Befehl ausführen und sich anmelden, bevor andere Befehle mit hoher Verfügbarkeit ordnungsgemäß funktionieren können. Hinweis: Das im Rahmen eines login Anrufs erworbene Microsoft Entra ID-Authentifizierungstoken ist nur 1 Stunde gültig, nachdem es abläuft. Sie können den login Befehl erneut ausführen, um ein neues Token abzurufen. Microsoft Entra ID Benutzername und Kennwort (bereitgestellt als Teil der Befehlsausführung, nicht anfänglicher Aufruf).
Get-OnPremisesDataGatewayClusters Ruft die Liste der Gatewaycluster für den angemeldeten Benutzer ab. Optional können Sie Formatierungsparameter an diesen Befehl übergeben, um die Lesbarkeit zu verbessern, z. B. Format-Table -AutoSize -Wrap.
Get-OnPremisesDataClusterGateways Ruft die Liste der Gateways innerhalb des angegebenen Clusters und zusätzliche Informationen für jedes Gateway ab, z. B. Online- oder Offlinestatus und Computername. -ClusterObjectID xyz (wobei xyz durch einen tatsächlichen Clusterobjekt-ID-Wert ersetzt wird, der mithilfe des Befehls "Get-OnPremisesDataGatewayClusters " abgerufen werden kann).
Set-OnPremisesDataGateway Verwenden Sie diesen Befehl, um Eigenschaftswerte für ein bestimmtes Gateway in einem Cluster festzulegen, das die Möglichkeit umfasst, eine bestimmte Gatewayinstanz zu aktivieren oder zu deaktivieren. -ClusterObjectID xyz (wobei xyz durch einen tatsächlichen Clusterobjekt-ID-Wert ersetzt wird, der mithilfe des Befehls "Get-OnPremisesDataGatewayClusters " abgerufen werden kann).

-GatewayObjectID abc (wobei abc durch einen tatsächlichen Gatewayobjekt-ID-Wert ersetzt wird, der mithilfe des Befehls "Get-OnPremisesDataClusterGateways " mit einer Clusterobjekt-ID abgerufen werden kann).
Get-OnPremisesDataGatewayStatus Verwenden Sie diesen Befehl, um den Status einer bestimmten Gatewayinstanz innerhalb eines Clusters abzurufen. -ClusterObjectID xyz (wobei xyz durch einen tatsächlichen Clusterobjekt-ID-Wert ersetzt wird, der mithilfe des Befehls "Get-OnPremisesDataGatewayClusters " abgerufen werden kann).

-GatewayObjectID abc (wobei abc durch einen tatsächlichen Gatewayobjekt-ID-Wert ersetzt wird, der mithilfe des Befehls "Get-OnPremisesDataClusterGateways " mit einer Clusterobjekt-ID abgerufen werden kann).
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 im Cluster entfernt werden. -ClusterObjectID xyz (wobei xyz durch einen tatsächlichen Clusterobjekt-ID-Wert ersetzt wird, der mithilfe des Befehls "Get-OnPremisesDataGatewayClusters " abgerufen werden kann).

-GatewayObjectID abc (wobei abc durch einen tatsächlichen Gatewayobjekt-ID-Wert ersetzt wird, der mithilfe des Befehls "Get-OnPremisesDataClusterGateways " mit einer Clusterobjekt-ID abgerufen werden kann).

Verwandte Inhalte

  • Last updated on