內部部署數據閘道叢集的PowerShell支援

  • 發行項

PowerShell 資源庫中提供 PowerShell 腳本。 本文所述的腳本適用於PowerShell第5版。 當您使用PowerShell第7版時，請參閱 PowerShell Cmdlet以取得內部部署數據閘道管理。 您可以使用 PowerShell 腳本來執行下列作業：

  • 擷取使用者可用的閘道叢集清單。
  • 擷取叢集中註冊的閘道實例清單及其在線或離線狀態。
  • 修改叢集內閘道實例和其他閘道屬性的啟用或停用狀態。
  • 刪除閘道。

執行 PowerShell 命令

若要安裝這些 Cmdlet，請在提升許可權的 PowerShell 工作階段中執行下列命令：

Install-Module -Name OnPremisesDataGatewayHAMgmt

您可以使用下列命令找到整個 Cmdlet 清單：

Get-Command -Module OnPremisesDataGateway*

Cmdlet 中包含範例和描述，您可以使用下列命令加以存取：

get-help <cmdlet-name>

現在您可以使用下表中的命令來管理閘道叢集。

命令 說明 參數
Login-OnPremisesDataGateway 使用此命令登入來管理內部部署數據閘道叢集。 您必須先執行此命令並登入 ，其他 高可用性命令才能正常運作。 注意：在通話中取得的 login Microsoft Entra ID 驗證令牌只有效 1 小時，之後才會到期。 您可以重新執行 login 命令以取得新的權杖。 Microsoft Entra ID 使用者名稱和密碼（提供做為命令執行的一部分，而不是初始調用）。
Get-OnPremisesDataGatewayClusters 擷取已登入使用者的閘道叢集清單。 您可以選擇性地將格式化參數傳遞至此命令，以取得更佳的可讀性，例如 Format-Table -AutoSize -Wrap。
Get-OnPremisesDataClusterGateways 擷取指定叢集中的閘道清單，以及每個閘道的其他資訊，例如在線或離線狀態和電腦名稱。 -ClusterObjectID xyz（其中 xyz 會取代為實際的叢集物件標識符值，您可以使用 Get-OnPremisesDataGatewayClusters 命令來擷取此值）。
Set-OnPremisesDataGateway 使用此命令來設定叢集內指定閘道的屬性值，包括啟用或停用特定網關實例的能力。 -ClusterObjectID xyz（其中 xyz 會取代為實際的叢集物件標識符值，您可以使用 Get-OnPremisesDataGatewayClusters 命令來擷取此值）。 -GatewayObjectID abc（其中 abc 會取代為實際的網關對象標識符值，其可使用 Get-OnPremisesDataClusterGateways 命令來擷取，指定叢集對象標識符）。
Get-OnPremisesDataGatewayStatus 使用此命令來擷取叢集中指定閘道實例的狀態。 -ClusterObjectID xyz（其中 xyz 會取代為實際的叢集物件標識符值，您可以使用 Get-OnPremisesDataGatewayClusters 命令來擷取此值）。 -GatewayObjectID abc（其中 abc 會取代為實際的網關對象標識符值，其可使用 Get-OnPremisesDataClusterGateways 命令來擷取，指定叢集對象標識符）。
Remove-OnPremisesDataGateway 使用此命令從叢集移除閘道實例。 注意：在移除叢集中所有其他閘道之前，無法移除叢集中的主要閘道。 -ClusterObjectID xyz（其中 xyz 會取代為實際的叢集物件標識符值，您可以使用 Get-OnPremisesDataGatewayClusters 命令來擷取此值）。 -GatewayObjectID abc（其中 abc 會取代為實際的網關對象標識符值，其可使用 Get-OnPremisesDataClusterGateways 命令來擷取，指定叢集對象標識符）。

下一步