Add-DataGatewayCluster

Ссылка

Модуль:: DataGateway

Создает новый кластер шлюза данных после установки шлюза на компьютере

Примечание. Чтобы использовать этот командлет, версия шлюза должна быть 3000.37.35 (апрель 2020 г.) или выше.

Синтаксис

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
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-OverwriteExistingGateway

Если этот параметр задан, он перезапишет существующую конфигурацию шлюза на локальном компьютере и настроит новую. Перезаписанный шлюз по-прежнему можно восстановить на другом компьютере.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-RecoveryKey

Ключ восстановления используется шлюзом для шифрования и расшифровки учетных данных на предварительной основе. Это также повторно используется для восстановления шлюза или добавления нового члена в кластер шлюза.

Тип:	SecureString
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-RegionKey

Этот параметр указывает регион Azure, связанный с шлюзом. Если параметр RegionKey не указан, используется регион Power BI по умолчанию для вашего клиента. Чтобы получить список доступных параметров региона, выполните командлет Get-DataGatewayRegion

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

Входные данные

None

Выходные данные

System.Void

Примечания

Эта команда должна выполняться с учетными данными на основе пользователя.

Поделиться через