Add-DataGatewayCluster

參考

模組:: DataGateway

在計算機上安裝閘道之後，建立新的數據閘道叢集

注意：若要使用此 Cmdlet，您的閘道版本必須 3000.37.35 （2020 年 4 月）或更高版本。

語法

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

Description

在計算機上安裝閘道之後，建立新的數據閘道叢集

範例

範例 1

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

建立名為「MyNewGateway」的新閘道。

範例 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

在巴西南部區域建立名為「MyNewGateway」的新閘道。您可以將加密的修復密鑰安全地儲存在檔案中，並將該金鑰傳遞至 Add-DataGatewayCluster，而不需要任何用戶互動。

範例 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

在巴西南部區域建立名為「MyNewGateway」的新閘道，並覆寫該本機電腦上現有的閘道設定，並設定新的閘道組態。您可以將加密的修復密鑰安全地儲存在檔案中，並將該金鑰傳遞至 Add-DataGatewayCluster，而不需要任何用戶互動。

參數

-GatewayName

這是將建立的閘道叢集名稱。它無法與相同租使用者上任何現有的閘道衝突。

類型:	String
別名:	Name
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-OverwriteExistingGateway

設定此參數時，它會覆寫本機計算機上的現有網關組態，並設定新的閘道組態。覆寫的閘道仍然可以在另一部電腦上復原。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RecoveryKey

閘道會使用修復金鑰來加密/解密內部部署認證。這也是為了還原閘道或將新成員新增至閘道叢集而重新清清。

類型:	SecureString
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-RegionKey

此參數指出與您的閘道相關聯的 Azure 區域。如果未提供 RegionKey，則會使用租用戶的預設 Power BI 區域。若要取得可用區域參數的清單，請執行 Get-DataGatewayRegion Cmdlet

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

None

輸出

System.Void

備註

此命令必須使用使用者型認證來執行。

共用方式為