Podpora Místního clusteru brány dat v PowerShellu
Skripty PowerShellu jsou k dispozici v galerii Prostředí PowerShell. Skripty popsané v tomto článku jsou určené pro PowerShell verze 5. Pokud používáte PowerShell verze 7, projděte si rutiny PowerShellu pro správu místní brány dat. Pomocí skriptů PowerShellu můžete provádět následující operace:
- Načtěte seznam clusterů bran, které jsou pro uživatele k dispozici.
- Načtěte seznam instancí brány zaregistrovaných v clusteru a jejich stav online nebo offline.
- Upravte stav povolení nebo zakázání instance brány v clusteru a dalších vlastnostech brány.
- Odstraňte bránu.
Spuštění příkazů PowerShellu
Pokud chcete nainstalovat tyto rutiny, spusťte v relaci PowerShellu se zvýšenými oprávněními následující příkaz:
Install-Module -Name OnPremisesDataGatewayHAMgmt
Celý seznam rutin najdete pomocí následujícího příkazu:
Get-Command -Module OnPremisesDataGateway*
Příklady a popisy jsou součástí rutin a můžete k nim přistupovat pomocí následujícího příkazu:
get-help <cmdlet-name>
Teď můžete ke správě clusterů brány použít příkazy v následující tabulce.
Příkaz | Popis | Parametry |
---|---|---|
Login-OnPremisesDataGateway | Pomocí tohoto příkazu se přihlaste ke správě clusterů místní brány dat. Abyste mohli správně pracovat s jinými příkazy s vysokou dostupností, musíte tento příkaz spustit a přihlásit se. Poznámka: Ověřovací token Microsoft Entra ID získaný v rámci login volání je platný pouze 1 hodinu, po jehož uplynutí vyprší platnost. Spuštěním login příkazu můžete znovu získat nový token. |
Uživatelské jméno a heslo ID Microsoft Entra (zadané jako součást provádění příkazu, nikoli počáteční vyvolání). |
Get-OnPremisesDataGatewayClusters | Načte seznam clusterů brány pro přihlášeného uživatele. | Volitelně můžete tomuto příkazu předat parametry formátování pro lepší čitelnost, například Format-Table -AutoSize -Wrap. |
Get-OnPremisesDataClusterGateways | Načte seznam bran v rámci zadaného clusteru a další informace pro každou bránu, jako je online nebo offline stav a název počítače. | -ClusterObjectID xyz (kde xyz je nahrazena skutečnou hodnotou ID objektu clusteru, kterou lze načíst pomocí příkazu Get-OnPremisesDataGatewayClusters ). |
Set-OnPremisesDataGateway | Tento příkaz použijte k nastavení hodnot vlastností pro danou bránu v clusteru, která zahrnuje možnost povolit nebo zakázat konkrétní instanci brány. | -ClusterObjectID xyz (kde xyz je nahrazena skutečnou hodnotou ID objektu clusteru, kterou lze načíst pomocí příkazu Get-OnPremisesDataGatewayClusters ). -GatewayObjectID abc (kde abc je nahrazen skutečnou hodnotou ID objektu brány, která se dá načíst pomocí příkazu Get-OnPremisesDataClusterGateways zadanou ID objektu clusteru). |
Get-OnPremisesDataGatewayStatus | Pomocí tohoto příkazu načtěte stav pro danou instanci brány v clusteru. | -ClusterObjectID xyz (kde xyz je nahrazena skutečnou hodnotou ID objektu clusteru, kterou lze načíst pomocí příkazu Get-OnPremisesDataGatewayClusters ). -GatewayObjectID abc (kde abc je nahrazen skutečnou hodnotou ID objektu brány, která se dá načíst pomocí příkazu Get-OnPremisesDataClusterGateways zadanou ID objektu clusteru). |
Remove-OnPremisesDataGateway | Pomocí tohoto příkazu odeberte instanci brány z clusteru. Poznámka: Primární brána v clusteru se nedá odebrat, dokud se neodeberou všechny ostatní brány v clusteru. | -ClusterObjectID xyz (kde xyz je nahrazena skutečnou hodnotou ID objektu clusteru, kterou lze načíst pomocí příkazu Get-OnPremisesDataGatewayClusters ). -GatewayObjectID abc (kde abc je nahrazen skutečnou hodnotou ID objektu brány, která se dá načíst pomocí příkazu Get-OnPremisesDataClusterGateways zadanou ID objektu clusteru). |