Add-DataGatewayCluster

参考

模块:: DataGateway

在计算机上安装网关后创建新的数据网关群集

注意：若要使用此 cmdlet，网关版本必须 3000.37.35 (2020 年 4 月) 或更高版本。

语法

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

说明

在计算机上安装网关后创建新的数据网关群集

示例

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

这是将创建的网关群集的名称。它不能与同一租户上的任何现有网关冲突。

Type:	String
Aliases:	Name
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-OverwriteExistingGateway

设置此参数后，它将覆盖本地计算机上的现有网关配置并配置新网关配置。覆盖的网关仍可在另一台计算机上恢复。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RecoveryKey

网关使用恢复密钥加密/解密本地凭据。这也是为了还原网关或向网关群集添加新成员而重新请求的。

Type:	SecureString
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-RegionKey

此参数指示与网关关联的 Azure 区域。如果未提供 RegionKey，则使用租户的默认 Power BI 区域。获取可用区域参数的列表，请运行 Get-DataGatewayRegion cmdlet

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

输入

None

输出

System.Void

备注

必须使用基于用户的凭据运行此命令。

通过