Add-DataGatewayCluster

Referência

Módulo:: DataGateway

Cria um novo cluster de gateway de dados depois que o gateway é instalado em um computador

Observação: para usar esse cmdlet, sua versão do gateway deve ser 3000.37.35 (abril de 2020) ou superior.

Sintaxe

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

Description

Cria um novo cluster de gateway de dados depois que o gateway é instalado em um computador

Exemplos

Exemplo 1

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

Cria um novo gateway chamado "MyNewGateway".

Exemplo 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

Cria um novo gateway chamado "MyNewGateway" na região Sul do Brasil. Você pode armazenar com segurança a chave de recuperação criptografada em um arquivo e passá-la para Add-DataGatewayCluster sem nenhuma interação do usuário.

Exemplo 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

Cria um novo gateway chamado "MyNewGateway" na região Sul do Brasil e substitui a configuração de gateway existente nesse computador local e configura o novo. Você pode armazenar com segurança a chave de recuperação criptografada em um arquivo e passá-la para Add-DataGatewayCluster sem nenhuma interação do usuário.

Parâmetros

-GatewayName

Esse é o nome do cluster de gateway que será criado. Ele não pode entrar em conflito com os gateways existentes no mesmo locatário.

Tipo:	String
Aliases:	Name
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-OverwriteExistingGateway

Quando esse parâmetro for definido, ele substituirá a configuração de gateway existente no computador local e configurará uma nova. O gateway substituído ainda pode ser recuperado em outro computador.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-RecoveryKey

A chave de recuperação é usada pelo gateway para criptografar/descriptografar credenciais no local. Isso também é solicitado a restaurar o gateway ou adicionar um novo membro ao cluster de gateway.

Tipo:	SecureString
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-RegionKey

Esse parâmetro indica a região do Azure associada ao gateway. Quando um RegionKey não é fornecido, a região padrão do Power BI para seu locatário é usada. Para obter a lista de parâmetros de região disponíveis, execute o cmdlet Get-DataGatewayRegion

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

Entradas

None

Saídas

System.Void

Observações

Esse comando deve ser executado com uma credencial baseada no usuário.

Compartilhar via