Compartilhar via

Add-DataGatewayClusterMember

Módulo:
DataGateway Module

Cria um novo membro do cluster do gateway de dados em um cluster existente depois que o gateway é instalado em uma máquina

Para usar esse cmdlet, a versão do gateway deve ser 3000.162.9 (fevereiro de 2023) ou superior. Esses cmdlets exigem o Powershell 7 ou superior. Para obter mais informações, consulte a documentação on-line para obter diretrizes de instalação.

Sintaxe

Default (Padrão) 

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

Description

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

Exemplos

Exemplo 1

$addDataGatewayClusterMemberSplat = @{
    RecoveryKey = (Read-Host "Recovery Key" -AsSecureString)
    GatewayName = "MyNewGatewayMember"
    GatewayClusterId = "14e63994-6c2c-4fda-a2b1-3fc27079c855"
}
Add-DataGatewayClusterMember @addDataGatewayClusterMemberSplat

Exemplo 2

$secureRecoveryKey = Read-Host "Enter Recovery Key" -AsSecureString
$addDataGatewayClusterMemberSplat = @{
    RecoveryKey = $secureRecoveryKey
    Name = "MyNewGatewayMember"
    GatewayClusterId = "14e63994-6c2c-4fda-a2b1-3fc27079c855"
}
Add-DataGatewayClusterMember @addDataGatewayClusterMemberSplat

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.

Parâmetros

-GatewayClusterId

Cluster de gateway ao qual a fonte de dados pertence.

Propriedades do parâmetro

Tipo:Guid
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:Clúster, ID

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

-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

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

None

Observações

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