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
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de