Información general de los cmdlets de PowerShell para grupos de disponibilidad AlwaysOn (SQL Server)

Artículo
06/25/2013

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

En este tema se describen los cmdlets de los siguientes conjuntos de tareas:

Configurar una instancia de servidor para grupos de disponibilidad AlwaysOn
Realizar copias de seguridad y restaurar bases de datos y registros de transacciones
Crear y administrar un grupo de disponibilidad
Crear y administrar un agente de escucha de un grupo de disponibilidad
Crear y administrar una réplica de disponibilidad
Agregar y administrar una base de datos de disponibilidad
Supervisar el estado de grupos de disponibilidad

[!NOTA]

Para obtener una lista de los temas de los Libros en pantalla de SQL Server 2012 que describen cómo utilizar los cmdlets para realizar tareas de Grupos de disponibilidad AlwaysOn, vea la sección "Tareas relacionadas” de Información general de 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, InputObject o Name. (Debe ser una edición de SQL Server 2012 que admita Grupos de disponibilidad AlwaysOn).
Enable-SqlAlwaysOn	Habilita Grupos de disponibilidad AlwaysOn en una instancia de SQL Server 2012 que admite la característica Grupos de disponibilidad AlwaysOn. Para obtener información sobre compatibilidad con Grupos de disponibilidad AlwaysOn, vea Requisitos previos, restricciones y recomendaciones para Grupos de disponibilidad AlwaysOn (SQL Server).	Cualquier edición de SQL Server 2012 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

Icono de flecha usado con el vínculo Volver al principio [Arriba]

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

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 obtener información sobre cómo utilizar estos cmdlets para preparar una base de datos secundaria, vea Preparar manualmente una base de datos secundaria para un grupo de disponibilidad (SQL Server).

Icono de flecha usado con el vínculo Volver al principio [Arriba]

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

Icono de flecha usado con el vínculo Volver al principio [Arriba]

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

Icono de flecha usado con el vínculo Volver al principio [Arriba]

Crear y administrar una réplica de disponibilidad

Cmdlets	Descripción	Se admite en
New-SqlAvailabilityReplica	Crea una nueva réplica de disponibilidad. Puede utilizar 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

Icono de flecha usado con el vínculo Volver al principio [Arriba]

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.

Icono de flecha usado con el vínculo Volver al principio [Arriba]

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.

Nota de seguridad
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 obtener más información, vea Usar directivas de AlwaysOn para ver el estado de un grupo de disponibilidad (SQL Server).

Icono de flecha usado con el vínculo Volver al principio [Arriba]