Compartir a través de

Add-DataGatewayClusterMember

Módulo:
DataGateway Module

Crea un nuevo miembro de clúster de puerta de enlace de datos en un clúster existente una vez que la puerta de enlace se ha instalado en un equipo

Para usar este cmdlet, la versión de la puerta de enlace debe ser 3000.162.9 (febrero de 2023) o superior. Estos cmdlets requieren PowerShell 7 o superior. Para obtener más información, consulte la documentación en línea para conocer las pautas de instalación.

Sintaxis

Default (Es el valor predeterminado). 

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

Description

Crea un nuevo miembro del clúster de puerta de enlace de datos una vez que la puerta de enlace se ha instalado en un equipo

Ejemplos

Ejemplo 1

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

Ejemplo 2

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

Crea una nueva puerta de enlace denominada "MyNewGateway" en la región Sur de Brasil. Puede almacenar de forma segura la clave de recuperación cifrada en un archivo y pasarla a Add-DataGatewayCluster sin ninguna interacción del usuario.

Parámetros

-GatewayClusterId

Clúster de puerta de enlace al que pertenece el origen de datos.

Propiedades del parámetro

Tipo:Guid
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Clúster, Id

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-GatewayName

Este es el nombre del clúster de puerta de enlace que se creará. No puede entrar en conflicto con ninguna puerta de enlace existente en el mismo inquilino.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Nombre

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-OverwriteExistingGateway

Cuando se establece este parámetro, sobrescribiría la configuración de puerta de enlace existente en el equipo local y configuraría una nueva. La puerta de enlace sobrescrita aún se puede recuperar en otra computadora.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RecoveryKey

La puerta de enlace utiliza la clave de recuperación para cifrar o descifrar las credenciales locales. Esto también es necesario para restaurar la puerta de enlace o agregar un nuevo miembro al clúster de puerta de enlace.

Propiedades del parámetro

Tipo:SecureString
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

None

Salidas

None

Notas

Este comando debe ejecutarse con una credencial basada en el usuario.