Add-DataGatewayCluster

Modul:
DataGateway Module

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

Syntax

Default (Standard) 

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

Beskrivning

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 att användaren behöver göra något.

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 i en fil på ett säkert sätt och skicka den till Add-DataGatewayCluster utan att användaren behöver göra något.

Parametrar

-GatewayName

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokrar:False
DontShow:False
Alias:Namn

Parametermängder

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter fastighetsnamn:False
Värde från återstående argument:False

-OverwriteExistingGateway

När den här parametern har angetts skriver den över den befintliga gatewaykonfigurationen på den lokala datorn och konfigurerar en ny. Den överskrivna gatewayen kan fortfarande återställas på en annan dator.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokrar:False
DontShow:False

Parametermängder

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter fastighetsnamn:False
Värde från återstående argument:False

-RecoveryKey

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

Parameteregenskaper

Typ:SecureString
Standardvärde:None
Stöder jokrar:False
DontShow:False

Parametermängder

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter fastighetsnamn:False
Värde från återstående argument: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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokrar:False
DontShow:False

Parametermängder

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter fastighetsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Ingångar

None

Utgångar

System.Void

Anteckningar

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