PowerShell-stöd för lokala datagatewaykluster

  • Artikel

PowerShell-skript är tillgängliga i PowerShell-galleriet. Skripten som beskrivs i den här artikeln är för PowerShell version 5. När du använder PowerShell version 7 läser du PowerShell-cmdletar för lokal datagatewayhantering. Du kan använda PowerShell-skripten för att utföra följande åtgärder:

  • Hämta listan över gatewaykluster som är tillgängliga för en användare.
  • Hämta listan över gatewayinstanser som är registrerade i ett kluster och deras online- eller offlinestatus.
  • Ändra statusen aktivera eller inaktivera för en gatewayinstans i ett kluster och andra gatewayegenskaper.
  • Ta bort en gateway.

Kör PowerShell-kommandona

Om du vill installera dessa cmdletar kör du följande kommando i en upphöjd PowerShell-session:

Install-Module -Name OnPremisesDataGatewayHAMgmt

Hela listan över cmdletar finns med följande kommando:

Get-Command -Module OnPremisesDataGateway*

Exempel och beskrivningar ingår i cmdletarna och du kan komma åt dem med hjälp av följande kommando:

get-help <cmdlet-name>

Nu kan du använda kommandona i följande tabell för att hantera dina gatewaykluster.

Kommando Beskrivning Parametrar
Login-OnPremisesDataGateway Använd det här kommandot för att logga in för att hantera dina lokala datagatewaykluster. Du måste köra det här kommandot och logga in innan andra kommandon med hög tillgänglighet kan fungera korrekt. Obs! Microsoft Entra ID-autentiseringstoken som hämtats som en del av ett login anrop är giltig i endast 1 timme, varefter den upphör att gälla. Du kan köra kommandot igen login för att hämta en ny token. Användarnamn och lösenord för Microsoft Entra-ID (tillhandahålls som en del av kommandokörningen, inte inledande anrop).
Get-OnPremisesDataGatewayClusters Hämtar listan över gatewaykluster för den inloggade användaren. Du kan också skicka formateringsparametrar till det här kommandot för bättre läsbarhet, till exempel Format-Table -AutoSize -Wrap.
Get-OnPremisesDataClusterGateways Hämtar listan över gatewayer i det angivna klustret och ytterligare information för varje gateway, till exempel online- eller offlinestatus och datornamn. -ClusterObjectID xyz (där xyz ersätts med ett faktiskt klusterobjekt-ID-värde, som kan hämtas med hjälp av kommandot Get-OnPremisesDataGatewayClusters ).
Set-OnPremisesDataGateway Använd det här kommandot för att ange egenskapsvärden för en viss gateway i ett kluster, vilket innefattar möjligheten att aktivera eller inaktivera en specifik gatewayinstans. -ClusterObjectID xyz (där xyz ersätts med ett faktiskt klusterobjekt-ID-värde, som kan hämtas med hjälp av kommandot Get-OnPremisesDataGatewayClusters ). -GatewayObjectID abc (där abc ersätts med ett faktiskt gatewayobjekt-ID-värde, som kan hämtas med hjälp av kommandot Get-OnPremisesDataClusterGateways , givet ett klusterobjekt-ID).
Get-OnPremisesDataGatewayStatus Använd det här kommandot för att hämta statusen för en viss gatewayinstans i ett kluster. -ClusterObjectID xyz (där xyz ersätts med ett faktiskt klusterobjekt-ID-värde, som kan hämtas med hjälp av kommandot Get-OnPremisesDataGatewayClusters ). -GatewayObjectID abc (där abc ersätts med ett faktiskt gatewayobjekt-ID-värde, som kan hämtas med hjälp av kommandot Get-OnPremisesDataClusterGateways , givet ett klusterobjekt-ID).
Remove-OnPremisesDataGateway Använd det här kommandot för att ta bort en gatewayinstans från ett kluster. Obs! Den primära gatewayen i klustret kan inte tas bort förrän alla andra gatewayer i klustret har tagits bort. -ClusterObjectID xyz (där xyz ersätts med ett faktiskt klusterobjekt-ID-värde, som kan hämtas med hjälp av kommandot Get-OnPremisesDataGatewayClusters ). -GatewayObjectID abc (där abc ersätts med ett faktiskt gatewayobjekt-ID-värde, som kan hämtas med hjälp av kommandot Get-OnPremisesDataClusterGateways , givet ett klusterobjekt-ID).

Nästa steg