Compatibilidad de PowerShell con los clústeres de puertas 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 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). |