Información general de los cmdlets de PowerShell para grupos de disponibilidad AlwaysOn

Se aplica a: SQL Server

Microsoft PowerShell es un shell de línea de comandos basado en tareas y un lenguaje de scripting diseñado especialmente para la administración del sistema. Grupos de disponibilidad AlwaysOn proporciona un conjunto de cmdlets de PowerShell en SQL Server que le permiten implementar, administrar y supervisar grupos de disponibilidad, réplicas de disponibilidad y bases de datos de disponibilidad.

Nota:

Un cmdlet de PowerShell se puede completar correctamente iniciando una acción. Esto no indica que el trabajo previsto, como la conmutación por error de un grupo de disponibilidad se haya completado. Cuando se genera el script de una secuencia de acciones, puede que tenga que comprobar el estado de las acciones y esperar a que se completen.

Nota:

Para ver una lista de los temas de los Libros en pantalla de SQL Server en los que se describe cómo usar cmdlets para realizar tareas de grupos de disponibilidad AlwaysOn, consulte la sección "Tareas relacionadas” de Introducción a los grupos de disponibilidad AlwaysOn (SQL Server).

Configurar una instancia de servidor para grupos de disponibilidad AlwaysOn

Cmdlets	Descripción	Se admite en
Disable-SqlAlwaysOn	Deshabilita la característica Grupos de disponibilidad AlwaysOn en una instancia de servidor.	La instancia de servidor especificada por el parámetro Path, InputObjecto Name . (Debe ser una edición de SQL Server que admita Grupos de disponibilidad AlwaysOn).
Enable-SqlAlwaysOn	Habilita Grupos de disponibilidad AlwaysOn en una instancia de SQL Server que admite la característica Grupos de disponibilidad AlwaysOn . Para información sobre la compatibilidad con grupos de disponibilidad AlwaysOn, consulte Requisitos previos, restricciones y recomendaciones para grupos de disponibilidad AlwaysOn (SQL Server).	Cualquier edición de SQL Server que admite Grupos de disponibilidad AlwaysOn.
New-SqlHadrEndPoint	Crea un nuevo extremo de creación de reflejo de la base de datos en una instancia de servidor. Este extremo es necesario para el movimiento de datos entre las bases de datos principal y secundaria.	Cualquier instancia de SQL Server
Set-SqlHadrEndpoint	Cambia las propiedades de un extremo de creación de reflejo de la base de datos existente, como el nombre, el estado o las propiedades de autenticación.	Una instancia de servidor que admite Grupos de disponibilidad AlwaysOn y no tiene un extremo de creación de reflejo de la base de datos

Realizar copias de seguridad y restaurar bases de datos y registros de transacciones

Cmdlets	Descripción	Se admite en
Backup-SqlDatabase	Crea una copia de seguridad de datos o del registro.	Cualquier base de datos en línea (en el caso Grupos de disponibilidad AlwaysOn, una base de datos de la instancia del servidor que hospeda la réplica principal)
Restore-SqlDatabase	Restaura una copia de seguridad.	Cualquier instancia de SQL Server (en el caso de Grupos de disponibilidad AlwaysOn, una instancia de servidor que hospeda una réplica secundaria)

Importante

Al preparar una base de datos secundaria, debe usar el parámetro -NoRecovery en cada comando Restore-SqlDatabase.

Para información sobre cómo usar estos cmdlets para preparar una base de datos secundaria, consulte Preparación manual una base de datos secundaria para un grupo de disponibilidad AlwaysOn (SQL Server).

Crear y administrar un grupo de disponibilidad

Cmdlets	Descripción	Se admite en
New-SqlAvailabilityGroup	Crea un nuevo grupo de disponibilidad.	Instancia del servidor para hospedar la réplica principal
Remove-SqlAvailabilityGroup	Elimina un grupo de disponibilidad.	Instancia del servidor habilitada para HADR
Set-SqlAvailabilityGroup	Establece las propiedades de un grupo de disponibilidad; poner en línea o sin conexión un grupo de disponibilidad	Instancia del servidor que hospeda la réplica principal
Switch-SqlAvailabilityGroup	Inicia una de las siguientes formas de conmutación por error Una conmutación por error forzada de un grupo de disponibilidad (con posible pérdida de datos). Una conmutación por error manual de un grupo de disponibilidad.	Instancia del servidor que hospeda la réplica secundaria de destino

Crear y administrar un agente de escucha de un grupo de disponibilidad

Cmdlet	Descripción	Se admite en
New-SqlAvailabilityGroupListener	Crea un nuevo agente de escucha del grupo de disponibilidad y lo adjunta a un grupo de disponibilidad existente.	Instancia del servidor que hospeda la réplica principal
Set-SqlAvailabilityGroupListener	Modifica la configuración del puerto en un agente de escucha del grupo de disponibilidad existente.	Instancia del servidor que hospeda la réplica principal
Add-SqlAvailabilityGroupListenerStaticIp	Agrega una dirección IP estática a una configuración de agente de escucha del grupo de disponibilidad existente. La dirección IP estática puede ser una dirección IPv4 con subred o una dirección IPv6.	Instancia del servidor que hospeda la réplica principal

Crear y administrar una réplica de disponibilidad

Cmdlets	Descripción	Se admite en
New-SqlAvailabilityReplica	Crea una nueva réplica de disponibilidad. Puede usar el parámetro -AsTemplate para crear un objeto de réplica de disponibilidad en memoria para cada nueva réplica de disponibilidad.	Instancia del servidor que hospeda la réplica principal
Join-SqlAvailabilityGroup	Combina una réplica secundaria con el grupo de disponibilidad.	Instancia del servidor que hospeda la réplica secundaria
Remove-SqlAvailabilityReplica	Elimina una réplica de disponibilidad.	Instancia del servidor que hospeda la réplica principal
Set-SqlAvailabilityReplica	Establece las propiedades de una réplica de disponibilidad.	Instancia del servidor que hospeda la réplica principal

Agregar y administrar una base de datos de disponibilidad

Cmdlets	Descripción	Se admite en
Add-SqlAvailabilityDatabase	En la réplica principal, agrega una base de datos a un grupo de disponibilidad. En una réplica secundaria, une una base de datos secundaria a un grupo de disponibilidad.	Cualquier instancia del servidor que hospeda una réplica de disponibilidad (el comportamiento difiere entre las réplicas principal y secundaria)
Remove-SqlAvailabilityDatabase	En la réplica principal, quita del grupo de disponibilidad la base de datos. En una réplica secundaria, quita la base de datos secundaria local de la réplica secundaria local.	Cualquier instancia del servidor que hospeda una réplica de disponibilidad (el comportamiento difiere entre las réplicas principal y secundaria)
Resume-SqlAvailabilityDatabase	Reanuda el movimiento de datos en una base de datos de disponibilidad suspendida.	La instancia de servidor en la que se ha suspendido la base de datos.
Suspend-SqlAvailabilityDatabase	Suspende el movimiento de datos en una base de datos de disponibilidad.	Cualquier instancia de servidor que hospeda una réplica de disponibilidad.

Supervisar el estado de grupos de disponibilidad

Los cmdlets siguientes de SQL Server permiten supervisar el estado de un grupo de disponibilidad y sus réplicas y bases de datos.

Importante

Debe tener permisos CONNECT, VIEW SERVER STATE y VIEW ANY DEFINITION para ejecutar estos cmdlets.

Cmdlet	Descripción	Se admite en
Test-SqlAvailabilityGroup	Evalúa el estado de un grupo de disponibilidad mediante la evaluación de las directivas de administración basada en directivas (PBM) de SQL Server.	Cualquier instancia de servidor que hospeda una réplica de disponibilidad.*
Test-SqlAvailabilityReplica	Evalúa el estado de las réplicas de disponibilidad mediante la evaluación de las directivas de administración basada en directivas (PBM) de SQL Server.	Cualquier instancia de servidor que hospeda una réplica de disponibilidad.*
Test-SqlDatabaseReplicaState	Evalúa el estado de una base de datos de disponibilidad en todas las réplicas de disponibilidad mediante la evaluación de directivas de administración basada en directivas (PBM) de SQL Server.	Cualquier instancia de servidor que hospeda una réplica de disponibilidad.*

*Para ver información acerca de todas las réplicas de disponibilidad en un grupo de disponibilidad, use la instancia del servidor que hospeda la réplica principal.

Para más información, consulte Usar directivas de AlwaysOn para ver el estado de un grupo de disponibilidad (SQL Server).

Consulte también

Información general de los grupos de disponibilidad AlwaysOn (SQL Server)
Get Help SQL Server PowerShell