Compartir a través de

Compatibilidad de PowerShell con clústeres de puerta de enlace de datos locales

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

  • Recupere la lista de clústeres de puerta de enlace disponibles para un usuario.
  • Recupere la lista de instancias de puerta de enlace registradas en un clúster y su estado en línea o sin conexión.
  • Modifique el estado de habilitación o deshabilitación de una instancia de puerta de enlace dentro de un clúster y otras propiedades de puerta de enlace.
  • Elimine una puerta de enlace.

Ejecución de los comandos de PowerShell

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

Install-Module -Name OnPremisesDataGatewayHAMgmt

Puede encontrar toda la lista de cmdlets mediante el siguiente comando:

Get-Command -Module OnPremisesDataGateway*

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

get-help <cmdlet-name>

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

Comando Descripción Parámetros
Login-OnPremisesDataGateway Use este comando para iniciar sesión para administrar los clústeres de puerta de enlace de datos locales. Debe ejecutar este comando e iniciar sesión para que otros comandos de alta disponibilidad puedan funcionar correctamente. Nota: El token de autenticación de id. de Microsoft Entra adquirido como parte de una login llamada es válido solo durante 1 hora, después de lo cual expira. Puede volver a ejecutar el login comando para adquirir un nuevo token. Nombre de usuario y contraseña de Microsoft Entra ID (proporcionado como parte de la ejecución del comando, no la invocación inicial).
Get-OnPremisesDataGatewayClusters Recupera la lista de clústeres de puerta de enlace para el usuario que ha iniciado sesión. Opcionalmente, puede pasar parámetros de formato a este comando para mejorar la legibilidad, como Format-Table -AutoSize -Wrap.
Get-OnPremisesDataClusterGateways Recupera la lista de puertas de enlace dentro del clúster especificado y información adicional para cada puerta de enlace, como el estado en línea o sin conexión y el nombre del equipo. -ClusterObjectID xyz (donde xyz se reemplaza por un valor real de identificador de objeto de clúster, que se puede recuperar mediante el comando Get-OnPremisesDataGatewayClusters ).
Set-OnPremisesDataGateway Use este comando para establecer valores de propiedad para una puerta de enlace determinada dentro de un clúster, lo que incluye la capacidad de habilitar o deshabilitar una instancia de puerta de enlace específica. -ClusterObjectID xyz (donde xyz se reemplaza por un valor real de identificador de objeto de clúster, que se puede recuperar mediante el comando Get-OnPremisesDataGatewayClusters ).

-GatewayObjectID abc (donde abc se reemplaza por un valor real de identificador de objeto de puerta de enlace, que se puede recuperar mediante el comando Get-OnPremisesDataClusterGateways , dado un identificador de objeto de clúster).
Get-OnPremisesDataGatewayStatus Use 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 valor real de identificador de objeto de clúster, que se puede recuperar mediante el comando Get-OnPremisesDataGatewayClusters ).

-GatewayObjectID abc (donde abc se reemplaza por un valor real de identificador de objeto de puerta de enlace, que se puede recuperar mediante el comando Get-OnPremisesDataClusterGateways , dado un identificador de objeto de clúster).
Eliminar OnPremisesDataGateway Use este comando para quitar una instancia de puerta de enlace de un clúster. Nota: La puerta de enlace principal del clúster no se puede quitar hasta que se quiten todas las demás puertas de enlace del clúster. -ClusterObjectID xyz (donde xyz se reemplaza por un valor real de identificador de objeto de clúster, que se puede recuperar mediante el comando Get-OnPremisesDataGatewayClusters ).

-GatewayObjectID abc (donde abc se reemplaza por un valor real de identificador de objeto de puerta de enlace, que se puede recuperar mediante el comando Get-OnPremisesDataClusterGateways , dado un identificador de objeto de clúster).

Contenido relacionado

  • Last updated on