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 gatewayversionen vara 3000.37.35 (april 2020) eller senare.

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 på ett säkert sätt i en fil och skicka den till Add-DataGatewayCluster utan någon 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 gatewaykonfigurationen som finns på den lokala datorn och konfigurerar den nya. Du kan lagra den krypterade återställningsnyckeln på ett säkert sätt i en fil och skicka den till Add-DataGatewayCluster utan någon användarinteraktion.

Parametrar

-GatewayName

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

Typ:	String
Alias:	Name
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-OverwriteExistingGateway

När den här parametern har angetts 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.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	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.

Typ:	SecureString
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-RegionKey

Den här parametern anger den Azure-region som är associerad med din gateway. När en RegionKey inte tillhandahålls 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

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

Indata

None

Utdata

System.Void

Kommentarer

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

Dela via