PowerShell-støtte for lokale datagatewayklynger
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). |