Partilhar via

Add-DataGatewayCluster

Módulo:
DataGateway Module

Cria um novo cluster de gateway de dados depois que o gateway for instalado em uma máquina

Sintaxe

Default (Predefinição) 

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

Description

Cria um novo cluster de gateway de dados depois que o gateway for instalado em uma máquina

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 qualquer 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 nessa máquina local e configura a nova. Você pode armazenar com segurança a chave de recuperação criptografada em um arquivo e passá-la para Add-DataGatewayCluster sem qualquer interação do usuário.

Parâmetros

-GatewayName

Este é o nome do cluster de gateway que será criado. Ele não pode entrar em conflito com nenhum gateway existente no mesmo locatário.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Nome

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-OverwriteExistingGateway

Quando esse parâmetro é definido, ele substitui a configuração de gateway existente na máquina local e configura uma nova. O gateway substituído ainda pode ser recuperado em outro computador.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-RecoveryKey

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

Propriedades dos parâmetros

Tipo:SecureString
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-RegionKey

Este parâmetro indica a região do Azure associada ao seu gateway. Quando uma RegionKey não é fornecida, 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 dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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

Notas

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