Add-DataGatewayCluster

リファレンス

モジュール:: DataGateway

ゲートウェイがマシンにインストールされたら、新しいデータゲートウェイクラスターを作成します

注: このコマンドレットを使用するには、ゲートウェイのバージョンが 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

これは、作成されるゲートウェイクラスターの名前です。同じテナント上の既存のゲートウェイと競合することはできません。

型:	String
Aliases:	Name
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-OverwriteExistingGateway

このパラメーターを設定すると、ローカルコンピューター上の既存のゲートウェイ構成が上書きされ、新しいゲートウェイ構成が構成されます。上書きされたゲートウェイは、引き続き別のコンピューターで回復できます。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RecoveryKey

回復キーは、オンプレミスの資格情報を暗号化または復号化するためにゲートウェイによって使用されます。これは、ゲートウェイを復元するか、ゲートウェイクラスターに新しいメンバーを追加するためにも再要求されます。

型:	SecureString
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RegionKey

このパラメーターは、ゲートウェイに関連付けられている Azure リージョンを示します。 RegionKey が指定されていない場合は、テナントの既定の Power BI リージョンが使用されます。使用可能なリージョンパラメーターの一覧を取得するには、Get-DataGatewayRegion コマンドレットを実行します

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

None

出力

System.Void

メモ

このコマンドは、ユーザーベースの資格情報で実行する必要があります。

次の方法で共有