Podpora prostredia PowerShell pre klastre lokálnych brán údajov

Skripty prostredia PowerShell sú k dispozícii v galérii prostredia PowerShell. Skripty popísané v tomto článku sú pre prostredie PowerShell verzie 5. Keď používate prostredie PowerShell verzie 7, pozrite si tému Rutiny typu cmdlet prostredia PowerShell pre správu lokálnej brány údajov. Pomocou skriptov prostredia PowerShell môžete vykonávať nasledujúce operácie:

  • Načíta zoznam klastrov brán, ktoré sú pre používateľa k dispozícii.
  • Načíta zoznam inštancií brány registrovaných v klastri a ich stav online alebo offline.
  • Upravte stav Povoliť alebo Zakázať pre inštanciu brány v rámci klastra a ďalších vlastností brány.
  • Odstrániť bránu.

Spustenie príkazov prostredia PowerShell

Ak chcete nainštalovať tieto rutiny typu cmdlet, spustite nasledujúci príkaz v relácii prostredia PowerShell s právami správcu:

Install-Module -Name OnPremisesDataGatewayHAMgmt

Celý zoznam rutín typu cmdlet možno nájsť pomocou nasledujúceho príkazu:

Get-Command -Module OnPremisesDataGateway*

Príklady a popisy sú súčasťou rutín typu cmdlet a môžete k nim získať prístup pomocou nasledujúceho príkazu:

get-help <cmdlet-name>

Teraz môžete pomocou príkazov v nasledujúcej tabuľke spravovať klastre brán.

Príkaz Popis Parametre
Login-OnPremisesDataGateway Ak chcete spravovať klastre lokálnych brán údajov, prihláste sa pomocou tohto príkazu. Najskôr je potrebné spustiť tento príkaz a prihlásiť sa. Až potom budú správne fungovať ostatné príkazy vysokej dostupnosti. Poznámka: Overový token Microsoft Entra ID získaný ako súčasť login volania je platný len 1 hodinu a potom jeho platnosť vyprší. Môžete znova spustiť login príkaz, aby ste získali nový token. Meno používateľa a heslo používateľa a hesla spoločnosti Microsoft Entra (poskytnuté v rámci vykonania príkazu, nie počiatočného vyvolania).
Get-OnPremisesDataGatewayClusters Načíta zoznam klastrov brán pre prihláseného používateľa. Voliteľne môžete tomuto príkazu odovzdať formátovacie parametre na zlepšenie čitateľnosti, napríklad Format-Table -AutoSize -Wrap.
Get-OnPremisesDataClusterGateways Načíta zoznam brán v rámci zadaného klastra a ďalšie informácie pre každú bránu, ako je stav online alebo offline, a názov počítača. -ClusterObjectID xyz (kde xyz sa nahrádza skutočnou hodnotou ID objektu klastra, ktorú možno načítať pomocou príkazu Get-OnPremisesDataGatewayClusters ).
Set-OnPremisesDataGateway Pomocou tohto príkazu môžete nastaviť hodnoty vlastností pre danú bránu v klastri, čo zahŕňa možnosť povoliť alebo zakázať konkrétnu inštanciu brány. -ClusterObjectID xyz (kde xyz sa nahrádza skutočnou hodnotou ID objektu klastra, ktorú možno načítať pomocou príkazu Get-OnPremisesDataGatewayClusters ). -GatewayObjectID abc (kde abc sa nahradí skutočnou hodnotou ID objektu brány, ktorú možno načítať pomocou príkazu Get-OnPremisesDataClusterGateways vzhľadom na ID objektu klastra).
Get-OnPremisesDataGatewayStatus Pomocou tohto príkazu načítajte stav danej inštancie brány v rámci klastra. -ClusterObjectID xyz (kde xyz sa nahrádza skutočnou hodnotou ID objektu klastra, ktorú možno načítať pomocou príkazu Get-OnPremisesDataGatewayClusters ). -GatewayObjectID abc (kde abc sa nahradí skutočnou hodnotou ID objektu brány, ktorú možno načítať pomocou príkazu Get-OnPremisesDataClusterGateways vzhľadom na ID objektu klastra).
Remove-OnPremisesDataGateway Použite tento príkaz na odstránenie inštancie brány z klastra. Poznámka: Primárnu bránu v klastri nemožno odstrániť, kým sa z klastra neodstránia všetky ostatné brány. -ClusterObjectID xyz (kde xyz sa nahrádza skutočnou hodnotou ID objektu klastra, ktorú možno načítať pomocou príkazu Get-OnPremisesDataGatewayClusters ). -GatewayObjectID abc (kde abc sa nahradí skutočnou hodnotou ID objektu brány, ktorú možno načítať pomocou príkazu Get-OnPremisesDataClusterGateways vzhľadom na ID objektu klastra).

Ďalšie kroky