Del via

PowerShell-støtte for lokale datagatewayklynger

  • Artikkel

PowerShell-skript er tilgjengelige i PowerShell-galleriet. Skriptene som er beskrevet i denne artikkelen, er for PowerShell versjon 5. Når du bruker PowerShell versjon 7, kan du se PowerShell-cmdleter for lokal administrasjon av datagateway. Du kan bruke PowerShell-skriptene til å utføre følgende operasjoner:

  • Hent listen over gateway-klynger som er tilgjengelige for en bruker.
  • Hent listen over gatewayforekomster som er registrert i en klynge, og deres tilkoblet- eller frakoblede status.
  • Endre statusen aktiver eller deaktiver for en gatewayforekomst i en klynge og andre gatewayegenskaper.
  • Slett en gateway.

Kjør PowerShell-kommandoene

Hvis du vil installere disse cmdletene, kjører du følgende kommando i en hevet PowerShell-økt:

Install-Module -Name OnPremisesDataGatewayHAMgmt

Du finner hele listen over cmdleter ved hjelp av følgende kommando:

Get-Command -Module OnPremisesDataGateway*

Eksempler og beskrivelser er inkludert i cmdletene, og du kan få tilgang til dem ved hjelp av følgende kommando:

get-help <cmdlet-name>

Nå kan du bruke kommandoene i tabellen nedenfor til å administrere gateway-klyngene.

Kommandoen Beskrivelse Parametere
Login-OnPremisesDataGateway Bruk denne kommandoen til å logge på for å administrere lokale datagatewayklynger. Du må kjøre denne kommandoen og logge på før andre kommandoer med høy tilgjengelighet kan fungere som de skal. Obs! Microsoft Entra ID-godkjenningstokenet som er anskaffet som en del av et login anrop, er gyldig i bare 1 time, hvoretter det utløper. Du kan kjøre kommandoen på nytt login for å hente et nytt token. Brukernavn og passord for Microsoft Entra ID (angitt som en del av kjøringen av kommandoen, ikke innledende aktivering).
Get-OnPremisesDataGatewayClusters Henter listen over gateway-klynger for den påloggede brukeren. Du kan eventuelt sende formateringsparametere til denne kommandoen for bedre lesbarhet, for eksempel Format-Table -AutoSize -Wrap.
Get-OnPremisesDataClusterGateways Henter listen over gatewayer i den angitte klyngen og tilleggsinformasjon for hver gateway, for eksempel tilkoblet eller frakoblet status og maskinnavn. -ClusterObjectID xyz (der xyz erstattes med en faktisk klyngeobjekt-ID-verdi, som kan hentes ved hjelp av kommandoen Get-OnPremisesDataGatewayClusters ).
Set-OnPremisesDataGateway Bruk denne kommandoen til å angi egenskapsverdier for en gitt gateway i en klynge, som inkluderer muligheten til å aktivere eller deaktivere en bestemt gatewayforekomst. -ClusterObjectID xyz (der xyz erstattes med en faktisk klyngeobjekt-ID-verdi, som kan hentes ved hjelp av kommandoen Get-OnPremisesDataGatewayClusters ). -GatewayObjectID abc (der abc erstattes med en faktisk gateway-objekt-ID-verdi, som kan hentes ved hjelp av kommandoen Get-OnPremisesDataClusterGateways , gitt en klyngeobjekt-ID).
Get-OnPremisesDataGatewayStatus Bruk denne kommandoen til å hente statusen for en gitt gatewayforekomst i en klynge. -ClusterObjectID xyz (der xyz erstattes med en faktisk klyngeobjekt-ID-verdi, som kan hentes ved hjelp av kommandoen Get-OnPremisesDataGatewayClusters ). -GatewayObjectID abc (der abc erstattes med en faktisk gateway-objekt-ID-verdi, som kan hentes ved hjelp av kommandoen Get-OnPremisesDataClusterGateways , gitt en klyngeobjekt-ID).
Remove-OnPremisesDataGateway Bruk denne kommandoen til å fjerne en gatewayforekomst fra en klynge. Obs! Den primære gatewayen i klyngen kan ikke fjernes før alle andre gatewayer i klyngen er fjernet. -ClusterObjectID xyz (der xyz erstattes med en faktisk klyngeobjekt-ID-verdi, som kan hentes ved hjelp av kommandoen Get-OnPremisesDataGatewayClusters ). -GatewayObjectID abc (der abc erstattes med en faktisk gateway-objekt-ID-verdi, som kan hentes ved hjelp av kommandoen Get-OnPremisesDataClusterGateways , gitt en klyngeobjekt-ID).

Neste trinn