Add-DataGatewayCluster

Referentie

Module:: DataGateway

Hiermee maakt u een nieuw gegevensgatewaycluster zodra de gateway op een computer is geïnstalleerd

Opmerking: als u deze cmdlet wilt gebruiken, moet uw gatewayversie 3000.37.35 (april 2020) of hoger zijn.

Syntaxis

Add-DataGatewayCluster
   -RecoveryKey <SecureString>
   -GatewayName <String>
   [-RegionKey <String>]
   [-OverwriteExistingGateway]
   [<CommonParameters>]

Description

Hiermee maakt u een nieuw gegevensgatewaycluster zodra de gateway op een computer is geïnstalleerd

Voorbeelden

Voorbeeld 1

PS C:\> Add-DataGatewayCluster -Name "MyNewGateway" -RecoveryKey (Read-Host "Enter Recovery Key" -AsSecureString)

Hiermee maakt u een nieuwe gateway met de naam MyNewGateway.

Voorbeeld 2

PS C:\> ConvertFrom-SecureString -SecureString (Read-Host "Enter Recovery Key" -AsSecureString) | Out-File -FilePath .\encryptedRecoveryKey.txt
PS C:\> $secureRecoveryKey = (cat .\encryptedRecoveryKey.txt | ConvertTo-SecureString)
PS C:\> Add-DataGatewayCluster -RecoveryKey $secureRecoveryKey -Name "MyNewGateway" -RegionKey brazilsouth

Hiermee maakt u een nieuwe gateway met de naam 'MyNewGateway' in de regio Brazilië - zuid. U kunt de versleutelde herstelsleutel veilig opslaan in een bestand en deze doorgeven aan Add-DataGatewayCluster zonder tussenkomst van de gebruiker.

Voorbeeld 3

PS C:\> ConvertFrom-SecureString -SecureString (Read-Host "Enter Recovery Key" -AsSecureString) | Out-File -FilePath .\encryptedRecoveryKey.txt
PS C:\> $secureRecoveryKey = (cat .\encryptedRecoveryKey.txt | ConvertTo-SecureString)
PS C:\> Add-DataGatewayCluster -RecoveryKey $secureRecoveryKey -Name "MyNewGateway" -RegionKey brazilsouth -OverwriteExistingGateway

Hiermee maakt u een nieuwe gateway met de naam 'MyNewGateway' in de regio Brazilië - zuid en overschrijft u de gatewayconfiguratie die op die lokale computer bestaat en configureert u de nieuwe. U kunt de versleutelde herstelsleutel veilig opslaan in een bestand en deze doorgeven aan Add-DataGatewayCluster zonder tussenkomst van de gebruiker.

Parameters

-GatewayName

Dit is de naam van het gatewaycluster dat wordt gemaakt. Het kan niet conflicteren met bestaande gateways in dezelfde tenant.

Type:	String
Aliassen:	Name
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-OverwriteExistingGateway

Wanneer deze parameter is ingesteld, wordt de bestaande gatewayconfiguratie op de lokale computer overschreven en wordt er een nieuwe geconfigureerd. De overschreven gateway kan nog steeds worden hersteld op een andere computer.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-RecoveryKey

De herstelsleutel wordt door de gateway gebruikt om on-premises referenties te versleutelen/ontsleutelen. Dit wordt ook opnieuw uitgevoerd om de gateway te herstellen of een nieuw lid toe te voegen aan het gatewaycluster.

Type:	SecureString
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-RegionKey

Deze parameter geeft de Azure-regio aan die is gekoppeld aan uw gateway. Wanneer er geen RegionKey is opgegeven, wordt de standaard Power BI-regio voor uw tenant gebruikt. Voer de cmdlet Get-DataGatewayRegion uit om de lijst met beschikbare regioparameters op te halen

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Invoerwaarden

None

Uitvoerwaarden

System.Void

Notities

Deze opdracht moet worden uitgevoerd met een gebruikersreferentie.

Delen via