Add-DataGatewayCluster

Referenz

Modul:: DataGateway

Erstellt einen neuen Datengatewaycluster, nachdem das Gateway auf einem Computer installiert wurde.

Hinweis: Um dieses Cmdlet zu verwenden, muss Ihre Gatewayversion 3000.37.35 (April 2020) oder höher sein.

Syntax

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

Beschreibung

Erstellt einen neuen Datengatewaycluster, nachdem das Gateway auf einem Computer installiert wurde.

Beispiele

Beispiel 1

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

Erstellt ein neues Gateway namens "MyNewGateway".

Beispiel 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

Erstellt ein neues Gateway namens "MyNewGateway" in der Region Brasilien Süd. Sie können den verschlüsselten Wiederherstellungsschlüssel sicher in einer Datei speichern und diesen ohne Benutzerinteraktion an Add-DataGatewayCluster übergeben.

Beispiel 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

Erstellt ein neues Gateway namens "MyNewGateway" in der Region Brasilien Süd und überschreibt die Gatewaykonfiguration, die auf diesem lokalen Computer vorhanden ist, und konfiguriert die neue. Sie können den verschlüsselten Wiederherstellungsschlüssel sicher in einer Datei speichern und diesen ohne Benutzerinteraktion an Add-DataGatewayCluster übergeben.

Parameter

-GatewayName

Dies ist der Name des Gatewayclusters, der erstellt wird. Es kann keine Konflikte mit vorhandenen Gateways auf demselben Mandanten verursachen.

Typ:	String
Aliase:	Name
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-OverwriteExistingGateway

Wenn dieser Parameter festgelegt ist, würde er die vorhandene Gatewaykonfiguration auf dem lokalen Computer überschreiben und eine neue konfigurieren. Das überschriebene Gateway kann weiterhin auf einem anderen Computer wiederhergestellt werden.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-RecoveryKey

Der Wiederherstellungsschlüssel wird vom Gateway zum Verschlüsseln/Entschlüsseln von lokalen Anmeldeinformationen verwendet. Dies wird auch aufgefordert, das Gateway wiederherzustellen oder dem Gatewaycluster ein neues Mitglied hinzuzufügen.

Typ:	SecureString
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-RegionKey

Dieser Parameter gibt die Azure-Region an, die Ihrem Gateway zugeordnet ist. Wenn kein RegionKey bereitgestellt wird, wird die Standardmäßige Power BI-Region für Ihren Mandanten verwendet. Um die Liste der verfügbaren Regionsparameter abzurufen, führen Sie das cmdlet Get-DataGatewayRegion aus

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

None

Ausgaben

System.Void

Hinweise

Dieser Befehl muss mit benutzerbasierten Anmeldeinformationen ausgeführt werden.

Freigeben über