Compatibilidad de PowerShell con los clústeres de puertas de enlace de datos locales

  • Artigo

Los scripts de PowerShell están disponibles en la Galería de PowerShell. Los scripts descritos en este artículo son para la versión 5 de PowerShell. Cuando utilice la versión 7 de PowerShell, consulte Cmdlets de PowerShell para la administración de la puerta de enlace de datos local. Puede usar los scripts de PowerShell para realizar las siguientes operaciones:

  • Recuperar la lista de clústeres de puertas de enlace disponibles para un usuario.
  • Recuperar la lista de instancias de puertas de enlace registradas en un clúster y su estado de conexión o desconexión.
  • Modificar el estado habilitado o deshabilitado de una instancia de puerta de enlace dentro de un clúster y otras propiedades de la puerta de enlace.
  • Eliminar una puerta de enlace.

Ejecutar los comandos de PowerShell

Para instalar estos cmdlets, ejecute el siguiente comando en una sesión elevada de PowerShell:

Install-Module -Name OnPremisesDataGatewayHAMgmt

La lista completa de cmdlets se puede encontrar con el siguiente comando:

Get-Command -Module OnPremisesDataGateway*

Se incluyen ejemplos y descripciones en los cmdlets y puede acceder a ellos mediante el siguiente comando:

get-help <cmdlet-name>

Ahora puede usar los comandos de la siguiente tabla para administrar los clústeres de puerta de enlace.

Comando Descripción Parámetros
Login-OnPremisesDataGateway Use este comando para iniciar sesión y administrar sus clústeres de puertas de enlace de datos locales. Debe ejecutar este comando e iniciar sesión antes para que otros comandos de alta disponibilidad funcionen correctamente. Nota: El token de autenticación de Microsoft Entra ID adquirido como parte una llamada de login solo es válido durante 1 hora y, después, expira. Puede volver a ejecutar el comando login para adquirir un nuevo token. Nombre de usuario y contraseña de Microsoft Entra ID (se proporciona como parte de la ejecución del comando, no en la invocación inicial).
Get-OnPremisesDataGatewayClusters Recupera la lista de clústeres de puertas de enlace del usuario que ha iniciado sesión. También puede pasar los parámetros de formato a este comando para mejorar la legibilidad, por ejemplo: Format-Table -AutoSize -Wrap.
Get-OnPremisesDataClusterGateways Recupera la lista de puertas de enlace dentro del clúster especificado e información adicional sobre cada puerta de enlace, como el estado de conexión o desconexión y el nombre de máquina. -ClusterObjectID xyz (donde xyz se reemplaza por un identificador de objeto de clúster, que se puede recuperar mediante el comando Get-OnPremisesDataGatewayClusters).
Set-OnPremisesDataGateway Utilice este comando para establecer los valores de las propiedades de una puerta de enlace determinada dentro de un clúster, lo que incluye la posibilidad de habilitar o deshabilitar una instancia de puerta de enlace específica. -ClusterObjectID xyz (donde xyz se reemplaza por un identificador de objeto de clúster, que se puede recuperar mediante el comando Get-OnPremisesDataGatewayClusters). -GatewayObjectID abc (donde abc se reemplaza por un identificador de objeto de puerta de enlace, que se puede recuperar mediante el comando Get-OnPremisesDataClusterGateways, dado un id. de objeto de clúster).
Get-OnPremisesDataGatewayStatus Utilice este comando para recuperar el estado de una instancia de puerta de enlace determinada dentro de un clúster. -ClusterObjectID xyz (donde xyz se reemplaza por un identificador de objeto de clúster, que se puede recuperar mediante el comando Get-OnPremisesDataGatewayClusters). -GatewayObjectID abc (donde abc se reemplaza por un identificador de objeto de puerta de enlace, que se puede recuperar mediante el comando Get-OnPremisesDataClusterGateways, dado un id. de objeto de clúster).
Remove-OnPremisesDataGateway Use este comando para eliminar una instancia de puerta de enlace de un clúster. Nota: La puerta de enlace principal del clúster no se puede eliminar hasta que se eliminen todas las demás puertas de enlace del clúster. -ClusterObjectID xyz (donde xyz se reemplaza por un identificador de objeto de clúster, que se puede recuperar mediante el comando Get-OnPremisesDataGatewayClusters). -GatewayObjectID abc (donde abc se reemplaza por un identificador de objeto de puerta de enlace, que se puede recuperar mediante el comando Get-OnPremisesDataClusterGateways, dado un id. de objeto de clúster).

Pasos siguientes