Add-DataGatewayCluster
Tworzy nowy klaster bramy danych po zainstalowaniu bramy na maszynie
Składnia
Default (Domyślna)
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 żadnej 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 żadnej interakcji z użytkownikiem.
Parametry
-GatewayName
Jest to nazwa klastra bramy, który zostanie utworzony. Nie może kolidować z żadnymi istniejącymi bramami w tej samej dzierżawie.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Nazwa |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-OverwriteExistingGateway
Gdy ten parametr zostanie ustawiony, zastąpi istniejącą konfigurację bramy na komputerze lokalnym i skonfiguruje nową. Zastąpioną bramę można nadal odzyskać na innym komputerze.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-RecoveryKey
Klucz odzyskiwania jest używany przez bramę do szyfrowania/odszyfrowywania poświadczeń lokalnych. Jest to również wymagane w celu przywrócenia bramy lub dodania nowego elementu członkowskiego do klastra bramy.
Właściwości parametru
| Typ: | SecureString |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | 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
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
Dane wejściowe
None
Dane wyjściowe
System.Void
Uwagi
To polecenie musi być uruchamiane z poświadczeniami opartymi na użytkowniku.