Add-DataGatewayCluster

Referens

Modul:: DataGateway

Skapar ett nytt datagatewaykluster när gatewayen har installerats på en dator

Obs! Om du vill använda den här cmdleten måste din gatewayversion vara 3000.37.35 (april 2020) eller högre.

Syntax

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

Description

Skapar ett nytt datagatewaykluster när gatewayen har installerats på en dator

Exempel

Exempel 1

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

Skapar en ny gateway med namnet "MyNewGateway".

Exempel 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

Skapar en ny gateway med namnet "MyNewGateway" i regionen Brasilien, södra. Du kan lagra den krypterade återställningsnyckeln i en fil på ett säkert sätt och skicka den till Add-DataGatewayCluster utan användarinteraktion.

Exempel 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

Skapar en ny gateway med namnet "MyNewGateway" i regionen Brasilien, södra och skriver över den gatewaykonfiguration som finns på den lokala datorn och konfigurerar den nya. Du kan lagra den krypterade återställningsnyckeln i en fil på ett säkert sätt och skicka den till Add-DataGatewayCluster utan användarinteraktion.

Parametrar

-GatewayName

Det här är namnet på det gatewaykluster som ska skapas. Det kan inte vara i konflikt med några befintliga gatewayer i samma klientorganisation.

Type:	String
Aliases:	Name
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-OverwriteExistingGateway

När den här parametern anges skulle den skriva över den befintliga gatewaykonfigurationen på den lokala datorn och konfigurera en ny. Den överskrivna gatewayen kan fortfarande återställas på en annan dator.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RecoveryKey

Återställningsnyckeln används av gatewayen för att kryptera/dekryptera lokala autentiseringsuppgifter. Detta är också requried för att återställa gatewayen eller lägga till en ny medlem i gatewayklustret.

Type:	SecureString
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-RegionKey

Den här parametern anger den Azure-region som är associerad med din gateway. När en RegionKey inte anges används Standard-Power BI-regionen för din klientorganisation. Om du vill hämta listan över tillgängliga regionparametrar kör du cmdleten Get-DataGatewayRegion

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Indata

None

Utdata

System.Void

Kommentarer

Det här kommandot måste köras med en användarbaserad autentiseringsuppgift.

Dela via