Add-DataGatewayCluster

Módulo:

DataGateway

Crea un clúster de puerta de enlace de datos una vez instalada la puerta de enlace en un equipo.

Nota: Para usar este cmdlet, la versión de la puerta de enlace debe ser 3000.37.35 (abril de 2020) o superior.

Sintaxis

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

Description

Crea un clúster de puerta de enlace de datos una vez instalada la puerta de enlace en un equipo.

Ejemplos

Ejemplo 1

PS C:\> Add-DataGatewayCluster -Name "MyNewGateway" -RecoveryKey (Read-Host "Enter Recovery Key" -AsSecureString)

Crea una nueva puerta de enlace denominada "MyNewGateway".

Ejemplo 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

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.

Ejemplo 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

Crea una nueva puerta de enlace denominada "MyNewGateway" en la región Sur de Brasil y sobrescribe la configuración de puerta de enlace existente en ese equipo local y configura la nueva. 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

-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.

Tipo:	String
Alias:	Name
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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 todavía se puede recuperar en otro equipo.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RecoveryKey

La puerta de enlace usa la clave de recuperación para cifrar o descifrar las credenciales locales. Esto también se vuelve a escribir para restaurar la puerta de enlace o agregar un nuevo miembro al clúster de puerta de enlace.

Tipo:	SecureString
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RegionKey

Este parámetro indica la región de Azure asociada a la puerta de enlace. Cuando no se proporciona una regionKey, se usa la región predeterminada de Power BI para el inquilino. Para obtener la lista de parámetros de región disponibles, ejecute el cmdlet Get-DataGatewayRegion

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

None

Salidas

System.Void

Notas

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