內部部署數據閘道叢集的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 命令來擷取，指定叢集對象標識符）。 |