PowerShell 腳本可在 PowerShell gallery 中使用。 本文所述的腳本適用於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 將被替換成實際的網關物件ID，此值可透過使用 Get-OnPremisesDataClusterGateways 指令並指定叢集物件ID來獲得）。 |
| Get-OnPremisesDataGatewayStatus | 使用此命令來擷取叢集中指定閘道實例的狀態。 |
-ClusterObjectID xyz （其中 xyz 會取代為實際的叢集物件標識符值，您可以使用 Get-OnPremisesDataGatewayClusters 命令來擷取此值）。 -GatewayObjectID abc （其中 abc 會被替換為實際的網關物件 ID 值，可以使用 Get-OnPremisesDataClusterGateways 命令來取得，前提是已指定叢集物件 ID）。 |
| 移除本機資料閘道器 | 使用此命令從叢集移除閘道實例。 注意：在移除叢集中所有其他閘道之前，無法移除叢集中的主要閘道。 |
-ClusterObjectID xyz （其中 xyz 會取代為實際的叢集物件標識符值，您可以使用 Get-OnPremisesDataGatewayClusters 命令來擷取此值）。 -GatewayObjectID abc （其中 abc 將被實際的網關物件識別碼取代，可以使用 Get-OnPremisesDataClusterGateways 命令擷取，並指定叢集物件識別碼）。 |