PowerShell-ondersteuning voor on-premises gegevensgatewayclusters
PowerShell-scripts zijn beschikbaar in de PowerShell-galerie. De scripts die in dit artikel worden beschreven, zijn bedoeld voor PowerShell versie 5. Wanneer u PowerShell versie 7 gebruikt, raadpleegt u PowerShell-cmdlets voor on-premises gegevensgatewaybeheer. U kunt de PowerShell-scripts gebruiken om de volgende bewerkingen uit te voeren:
- Haal de lijst met gatewayclusters op die beschikbaar zijn voor een gebruiker.
- Haal de lijst met gateway-exemplaren op die zijn geregistreerd in een cluster en hun online- of offlinestatus.
- Wijzig de status in- of uitschakelen voor een gateway-exemplaar binnen een cluster en andere gatewayeigenschappen.
- Een gateway verwijderen.
De PowerShell-opdrachten uitvoeren
Als u deze cmdlets wilt installeren, voert u de volgende opdracht uit in een PowerShell-sessie met verhoogde bevoegdheid:
Install-Module -Name OnPremisesDataGatewayHAMgmt
De volledige lijst met cmdlets vindt u met behulp van de volgende opdracht:
Get-Command -Module OnPremisesDataGateway*
Voorbeelden en beschrijvingen zijn opgenomen in de cmdlets en u kunt ze openen met behulp van de volgende opdracht:
get-help <cmdlet-name>
U kunt nu de opdrachten in de volgende tabel gebruiken om uw gatewayclusters te beheren.
| Command | Beschrijving | Parameters |
|---|---|---|
| Login-OnPremisesDataGateway | Gebruik deze opdracht om u aan te melden om uw on-premises gegevensgatewayclusters te beheren. U moet deze opdracht uitvoeren en u aanmelden voordat andere opdrachten met hoge beschikbaarheid goed kunnen werken. Opmerking: het verificatietoken van Microsoft Entra ID dat is verkregen als onderdeel van een login oproep, is slechts 1 uur geldig, waarna het verloopt. U kunt de login opdracht opnieuw uitvoeren om een nieuw token te verkrijgen. |
Gebruikersnaam en wachtwoord van Microsoft Entra-id (opgegeven als onderdeel van de uitvoering van de opdracht, niet de eerste aanroep). |
| Get-OnPremisesDataGatewayClusters | Haalt de lijst met gatewayclusters voor de aangemelde gebruiker op. | Desgewenst kunt u opmaakparameters doorgeven aan deze opdracht voor een betere leesbaarheid, zoals Opmaaktabel -AutoSize -Wrap. |
| Get-OnPremisesDataClusterGateways | Haalt de lijst met gateways op binnen het opgegeven cluster en aanvullende informatie voor elke gateway, zoals de online- of offlinestatus en computernaam. | -ClusterObjectID xyz (waarbij xyz wordt vervangen door een werkelijke waarde voor het clusterobject, die kan worden opgehaald met behulp van de opdracht Get-OnPremisesDataGatewayClusters ). |
| Set-OnPremisesDataGateway | Gebruik deze opdracht om eigenschapswaarden in te stellen voor een bepaalde gateway in een cluster, waaronder de mogelijkheid om een specifiek gatewayexemplaren in of uit te schakelen. | -ClusterObjectID xyz (waarbij xyz wordt vervangen door een werkelijke waarde voor het clusterobject, die kan worden opgehaald met behulp van de opdracht Get-OnPremisesDataGatewayClusters ). -GatewayObjectID abc (waarbij abc wordt vervangen door een werkelijke waarde van het gatewayobject, die kan worden opgehaald met behulp van de opdracht Get-OnPremisesDataClusterGateways , gegeven een clusterobject-id). |
| Get-OnPremisesDataGatewayStatus | Gebruik deze opdracht om de status voor een bepaald gateway-exemplaar in een cluster op te halen. | -ClusterObjectID xyz (waarbij xyz wordt vervangen door een werkelijke waarde voor het clusterobject, die kan worden opgehaald met behulp van de opdracht Get-OnPremisesDataGatewayClusters ). -GatewayObjectID abc (waarbij abc wordt vervangen door een werkelijke waarde van het gatewayobject, die kan worden opgehaald met behulp van de opdracht Get-OnPremisesDataClusterGateways , gegeven een clusterobject-id). |
| Remove-OnPremisesDataGateway | Gebruik deze opdracht om een gateway-exemplaar uit een cluster te verwijderen. Opmerking: de primaire gateway in het cluster kan pas worden verwijderd als alle andere gateways in het cluster zijn verwijderd. | -ClusterObjectID xyz (waarbij xyz wordt vervangen door een werkelijke waarde voor het clusterobject, die kan worden opgehaald met behulp van de opdracht Get-OnPremisesDataGatewayClusters ). -GatewayObjectID abc (waarbij abc wordt vervangen door een werkelijke waarde van het gatewayobject, die kan worden opgehaald met behulp van de opdracht Get-OnPremisesDataClusterGateways , gegeven een clusterobject-id). |