Sdílet prostřednictvím


Add-DataGatewayCluster

Po instalaci brány na počítač vytvoří nový cluster brány dat.

Poznámka: Pokud chcete tuto rutinu použít, musí být vaše verze brány 3000.37.35 (duben 2020) nebo novější.

Syntaxe

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

Description

Po instalaci brány na počítač vytvoří nový cluster brány dat.

Příklady

Příklad 1

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

Vytvoří novou bránu s názvem MyNewGateway.

Příklad 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

Vytvoří novou bránu s názvem MyNewGateway v oblasti Brazílie – jih. Šifrovaný obnovovací klíč můžete bezpečně uložit do souboru a předat ho do Add-DataGatewayCluster bez jakékoli interakce uživatele.

Příklad 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

Vytvoří novou bránu s názvem MyNewGateway v oblasti Brazílie – jih a přepíše konfiguraci brány existující na tomto místním počítači a nakonfiguruje novou bránu. Šifrovaný obnovovací klíč můžete bezpečně uložit do souboru a předat ho do Add-DataGatewayCluster bez jakékoli interakce uživatele.

Parametry

-GatewayName

Toto je název clusteru brány, který se vytvoří. Nemůže být v konfliktu s žádnou existující bránou ve stejném tenantovi.

Typ:String
Aliasy:Name
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-OverwriteExistingGateway

Když je tento parametr nastavený, přepíše stávající konfiguraci brány na místním počítači a nakonfiguruje novou. Přepsánou bránu je stále možné obnovit v jiném počítači.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RecoveryKey

Obnovovací klíč používá brána k šifrování nebo dešifrování místních přihlašovacích údajů. To se také znovu obnoví, aby se brána obnovila nebo přidal nový člen do clusteru brány.

Typ:SecureString
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RegionKey

Tento parametr označuje oblast Azure přidruženou k vaší bráně. Pokud není zadaný klíč oblasti, použije se výchozí oblast Power BI pro vašeho tenanta. Pokud chcete získat seznam dostupných parametrů oblasti, spusťte rutinu Get-DataGatewayRegion

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

None

Výstupy

System.Void

Poznámky

Tento příkaz musí být spuštěn s přihlašovacími údaji založenými na uživateli.