Share via

PowerShell-ondersteuning voor on-premises gegevensgatewayclusters

  • Artikel

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).

Volgende stappen