Compartilhar via

Add-DataGatewayCluster

Módulo:
DataGateway Module

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

Sintaxe

Default (Padrão) 

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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:Nome

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:SecureString
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

None

Saídas

System.Void

Observações

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