Partilhar via

Add-DataGatewayClusterMember

Módulo:
DataGateway Module

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

Para usar esse cmdlet, sua versão de 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 (Predefiniçã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 for 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 qualquer interação do usuário.

Parâmetros

-GatewayClusterId

Cluster de gateway ao qual a fonte de dados pertence.

Propriedades dos parâmetros

Tipo:Guid
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Aglomerado, Id

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

-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

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

Notas

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