PowerShell-understøttelse af datagatewayklynger i det lokale miljø
PowerShell-scripts er tilgængelige i PowerShell-galleriet. De scripts, der er beskrevet i denne artikel, er til PowerShell version 5. Når du bruger PowerShell version 7, kan du se PowerShell-cmdlet'er til administration af datagateway i det lokale miljø. Du kan bruge PowerShell-scripts til at udføre følgende handlinger:
- Hent listen over gatewayklynger, der er tilgængelige for en bruger.
- Hent listen over gatewayforekomster, der er registreret i en klynge, og deres online- eller offlinestatus.
- Rediger status for aktivering eller deaktivering af en gatewayforekomst i en klynge og andre gatewayegenskaber.
- Slet en gateway.
Kør PowerShell-kommandoerne
Hvis du vil installere disse cmdlet'er, skal du køre følgende kommando i en PowerShell-session med administratorrettigheder:
Install-Module -Name OnPremisesDataGatewayHAMgmt
Du kan finde hele listen over cmdlet'er ved hjælp af følgende kommando:
Get-Command -Module OnPremisesDataGateway*
Eksempler og beskrivelser er inkluderet i cmdlet'erne, og du kan få adgang til dem ved hjælp af følgende kommando:
get-help <cmdlet-name>
Nu kan du bruge kommandoerne i følgende tabel til at administrere dine gatewayklynger.
| Kommando | Beskrivelse | Parametre |
|---|---|---|
| Logon-OnPremisesDataGateway | Brug denne kommando til at logge på for at administrere dine datagatewayklynger i det lokale miljø. Du skal køre denne kommando og logge på, før andre kommandoer med høj tilgængelighed kan fungere korrekt. Bemærk! Det godkendelsestoken til Microsoft Entra ID, der er erhvervet som en del af et login opkald, er kun gyldigt i 1 time, hvorefter det udløber. Du kan køre kommandoen login igen for at hente et nyt token. |
Brugernavn og adgangskode til Microsoft Entra-id (leveres som en del af udførelsen af kommandoen, ikke den indledende aktivering). |
| Get-OnPremisesDataGatewayClusters | Henter listen over gatewayklynger for den bruger, der er logget på. | Du kan eventuelt overføre formateringsparametre til denne kommando for at få bedre læsevenlighed, f.eks . Format-Table -AutoSize -Wrap. |
| Get-OnPremisesDataClusterGateways | Henter listen over gateways i den angivne klynge og yderligere oplysninger for hver gateway, f.eks. online- eller offlinestatus og computernavn. | -ClusterObjectID xyz (hvor xyz erstattes af en faktisk objekt-id-værdi for klyngen, som kan hentes ved hjælp af kommandoen Get-OnPremisesDataGatewayClusters ). |
| Set-OnPremisesDataGateway | Brug denne kommando til at angive egenskabsværdier for en given gateway i en klynge, hvilket omfatter muligheden for at aktivere eller deaktivere en bestemt gatewayforekomst. | -ClusterObjectID xyz (hvor xyz erstattes af en faktisk objekt-id-værdi for klyngen, som kan hentes ved hjælp af kommandoen Get-OnPremisesDataGatewayClusters ). -GatewayObjectID abc (hvor abc erstattes med en faktisk værdi for gatewayobjekt-id'et, som kan hentes ved hjælp af kommandoen Get-OnPremisesDataClusterGateways med et objekt-id for klyngen). |
| Get-OnPremisesDataGatewayStatus | Brug denne kommando til at hente status for en given gatewayforekomst i en klynge. | -ClusterObjectID xyz (hvor xyz erstattes af en faktisk objekt-id-værdi for klyngen, som kan hentes ved hjælp af kommandoen Get-OnPremisesDataGatewayClusters ). -GatewayObjectID abc (hvor abc erstattes med en faktisk værdi for gatewayobjekt-id'et, som kan hentes ved hjælp af kommandoen Get-OnPremisesDataClusterGateways med et objekt-id for klyngen). |
| Remove-OnPremisesDataGateway | Brug denne kommando til at fjerne en gatewayforekomst fra en klynge. Bemærk! Den primære gateway i klyngen kan ikke fjernes, før alle andre gateways i klyngen er fjernet. | -ClusterObjectID xyz (hvor xyz erstattes af en faktisk objekt-id-værdi for klyngen, som kan hentes ved hjælp af kommandoen Get-OnPremisesDataGatewayClusters ). -GatewayObjectID abc (hvor abc erstattes med en faktisk værdi for gatewayobjekt-id'et, som kan hentes ved hjælp af kommandoen Get-OnPremisesDataClusterGateways med et objekt-id for klyngen). |