Información general de los cmdlets de PowerShell para grupos de disponibilidad AlwaysOn (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. Always On grupos de disponibilidad proporciona un conjunto de cmdlets de PowerShell en SQL Server 2014 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:

Nota:

Para obtener una lista de temas de SQL Server libros en pantalla de 2014 que describen cómo usar cmdlets para realizar tareas de Always On grupos de disponibilidad, consulte 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 de Always On 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 que admita Always On grupos de disponibilidad).
Enable-SqlAlwaysOn Habilita Always On grupos de disponibilidad en una instancia de SQL Server 2014 que admite la característica grupos de disponibilidad de Always On. Para obtener información sobre la compatibilidad con los grupos de disponibilidad de Always On, consulte Requisitos previos, restricciones y recomendaciones para grupos de disponibilidad AlwaysOn (SQL Server). Cualquier edición de SQL Server que admita Always On grupos de disponibilidad.
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 Always On grupos de disponibilidad y carece de un punto de conexión 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 (para Always On grupos de disponibilidad, una base de datos en la instancia del servidor que hospeda la réplica principal)
Restore-SqlDatabase Restaura una copia de seguridad. Cualquier instancia de SQL Server (para Always On grupos de disponibilidad, una instancia de servidor que hospeda una réplica secundaria)

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

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

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 obtener más información, vea Usar directivas 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