Add-DataGatewayCluster

Moduł:

DataGateway

Tworzy nowy klaster bramy danych po zainstalowaniu bramy na maszynie

Uwaga: aby użyć tego polecenia cmdlet, wersja bramy musi być 3000.37.35 (kwiecień 2020 r.) lub nowsza.

Składnia

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

Opis

Tworzy nowy klaster bramy danych po zainstalowaniu bramy na maszynie

Przykłady

Przykład 1

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

Tworzy nową bramę o nazwie "MyNewGateway".

Przykład 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

Tworzy nową bramę o nazwie "MyNewGateway" w regionie Brazylia Południowa. Zaszyfrowany klucz odzyskiwania można bezpiecznie przechowywać w pliku i przekazywać go do Add-DataGatewayCluster bez interakcji z użytkownikiem.

Przykład 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

Tworzy nową bramę o nazwie "MyNewGateway" w regionie Brazylia Południowa i zastępuje konfigurację bramy istniejącej na tym komputerze lokalnym i konfiguruje nową bramę. Zaszyfrowany klucz odzyskiwania można bezpiecznie przechowywać w pliku i przekazywać go do Add-DataGatewayCluster bez interakcji z użytkownikiem.

Parametry

-GatewayName

Jest to nazwa klastra bramy, który zostanie utworzony. Nie może on powodować konfliktu z żadnymi istniejącymi bramami w tej samej dzierżawie.

Typ:	String
Aliasy:	Name
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-OverwriteExistingGateway

Po ustawieniu tego parametru zastąpi istniejącą konfigurację bramy na komputerze lokalnym i skonfiguruje nową. Nadpisane bramy można nadal odzyskać na innym komputerze.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-RecoveryKey

Klucz odzyskiwania jest używany przez bramę do szyfrowania/odszyfrowywania poświadczeń lokalnych. Jest to również ponownie identyfikatorquried w celu przywrócenia bramy lub dodania nowego elementu członkowskiego do klastra bramy.

Typ:	SecureString
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-RegionKey

Ten parametr wskazuje region świadczenia usługi Azure skojarzony z bramą. Jeśli nie podano wartości RegionKey, używany jest domyślny region usługi Power BI dla dzierżawy. Aby uzyskać listę dostępnych parametrów regionu, uruchom polecenie cmdlet Get-DataGatewayRegion

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

Dane wejściowe

None

Dane wyjściowe

System.Void

Uwagi

To polecenie musi być uruchamiane przy użyciu poświadczeń opartych na użytkowniku.