Información general de los cmdlets de PowerShell para grupos de disponibilidad AlwaysOnOverview of PowerShell Cmdlets for Always On Availability Groups

SE APLICA A: síSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) noAlmacenamiento de datos paralelos APPLIES TO: yesSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

MicrosoftMicrosoft 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.PowerShell is a task-based command-line shell and scripting language designed especially for system administration. Grupos de disponibilidad AlwaysOnAlways On availability groups proporciona un conjunto de cmdlets de PowerShell en SQL ServerSQL Server que le permiten implementar, administrar y supervisar grupos de disponibilidad, réplicas de disponibilidad y bases de datos de disponibilidad.provides a set of PowerShell cmdlets in SQL ServerSQL Server that enable you to deploy, manage, and monitor availability groups, availability replicas, and availability databases.

Nota

Un cmdlet de PowerShell se puede completar correctamente iniciando una acción.A PowerShell cmdlet can complete by successfully initiating an action. Esto no indica que el trabajo previsto, como la conmutación por error de un grupo de disponibilidad se haya completado.This does not indicate that the intended work, such as the fail over of an availability group, has completed. 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.When scripting a sequence of actions, you might have to check the status of actions, and wait for them to complete.

Nota

Para obtener una lista de los temas de los Libros en pantalla de SQL ServerSQL Server en los que se describe cómo usar cmdlets para realizar tareas de Grupos de disponibilidad AlwaysOnAlways On availability groups , vea la sección "Tareas relacionadas” de Información general de los grupos de disponibilidad AlwaysOn (SQL Server).For a list of topics in SQL ServerSQL Server Books Online that describe how to use cmdlets to perform Grupos de disponibilidad AlwaysOnAlways On availability groups tasks, see the "Related Tasks" section of Overview of Always On Availability Groups (SQL Server).

Configurar AlwaysOn una instancia del servidor para grupos de disponibilidadConfiguring a Server Instance for Always On Availability Groups

CmdletsCmdlets DescripciónDescription Se admite enSupported on
Disable-SqlAlwaysOnDisable-SqlAlwaysOn Deshabilita la característica Grupos de disponibilidad AlwaysOnAlways On availability groups en una instancia de servidor.Disables the Grupos de disponibilidad AlwaysOnAlways On availability groups feature on a server instance. La instancia de servidor especificada por el parámetro Path, InputObjecto Name .The server instance that is specified by the Path, InputObject, or Name parameter. (Debe ser una edición de SQL ServerSQL Server que admita Grupos de disponibilidad AlwaysOnAlways On availability groups).(Must be an edition of SQL ServerSQL Server that supports Grupos de disponibilidad AlwaysOnAlways On availability groups.)
Enable-SqlAlwaysOnEnable-SqlAlwaysOn Habilita Grupos de disponibilidad AlwaysOnAlways On availability groups en una instancia de SQL ServerSQL Server que admite la característica Grupos de disponibilidad AlwaysOnAlways On availability groups .Enables Grupos de disponibilidad AlwaysOnAlways On availability groups on an instance of SQL ServerSQL Server that supports the Grupos de disponibilidad AlwaysOnAlways On availability groups feature. Para obtener más información sobre la compatibilidad de Grupos de disponibilidad AlwaysOnAlways On availability groups, vea Requisitos previos, restricciones y recomendaciones para Grupos de disponibilidad AlwaysOn (SQL Server).For information about support for Grupos de disponibilidad AlwaysOnAlways On availability groups, see Prerequisites, Restrictions, and Recommendations for Always On Availability Groups (SQL Server). Cualquier edición de SQL ServerSQL Server que admite Grupos de disponibilidad AlwaysOnAlways On availability groups.Any edition of SQL ServerSQL Server that supports Grupos de disponibilidad AlwaysOnAlways On availability groups.
New-SqlHadrEndPointNew-SqlHadrEndPoint Crea un nuevo extremo de creación de reflejo de la base de datos en una instancia de servidor.Creates a new database mirroring endpoint on a server instance. Este extremo es necesario para el movimiento de datos entre las bases de datos principal y secundaria.This endpoint is required for data movement between primary and secondary databases. Cualquier instancia de SQL ServerSQL ServerAny instance of SQL ServerSQL Server
Set-SqlHadrEndpointSet-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.Changes the properties of an existing database mirroring endpoint, such as the name, state, or authentication properties. Una instancia de servidor que admite Grupos de disponibilidad AlwaysOnAlways On availability groups y no tiene un extremo de creación de reflejo de la base de datosA server instance that supports Grupos de disponibilidad AlwaysOnAlways On availability groups and lacks a database mirroring endpoint

Copia de seguridad y restauración de bases de datos y registros de transaccionesBacking Up and Restoring Databases and Transaction Logs

CmdletsCmdlets DescripciónDescription Se admite enSupported on
Backup-SqlDatabaseBackup-SqlDatabase Crea una copia de seguridad de datos o del registro.Creates a data or log backup. Cualquier base de datos en línea (en el caso Grupos de disponibilidad AlwaysOnAlways On availability groups, una base de datos de la instancia del servidor que hospeda la réplica principal)Any online database (for Grupos de disponibilidad AlwaysOnAlways On availability groups, a database on the server instance that hosts the primary replica)
Restore-SqlDatabaseRestore-SqlDatabase Restaura una copia de seguridad.Restores a backup. Cualquier instancia de SQL ServerSQL Server (en el caso de Grupos de disponibilidad AlwaysOnAlways On availability groups, una instancia de servidor que hospeda una réplica secundaria)Any instance of SQL ServerSQL Server (for Grupos de disponibilidad AlwaysOnAlways On availability groups, a server instance that hosts a secondary replica)

Importante

Al preparar una base de datos secundaria, debe usar el parámetro -NoRecovery en cada comando Restore-SqlDatabase.When preparing a secondary database, you must use the -NoRecovery parameter in every Restore-SqlDatabase command.

Para obtener más información sobre cómo usar estos cmdlets para preparar una base de datos secundaria, vea Preparar manualmente una base de datos secundaria para un grupo de disponibilidad (SQL Server).For information about using these cmdlets to prepare a secondary database, see Manually Prepare a Secondary Database for an Availability Group (SQL Server).

Crear y administrar un grupo de disponibilidadCreating and Managing an Availability Group

CmdletsCmdlets DescripciónDescription Se admite enSupported on
New-SqlAvailabilityGroupNew-SqlAvailabilityGroup Crea un nuevo grupo de disponibilidad.Creates a new availability group. Instancia del servidor para hospedar la réplica principalServer instance to host primary replica
Remove-SqlAvailabilityGroupRemove-SqlAvailabilityGroup Elimina un grupo de disponibilidad.Deletes availability group. Instancia del servidor habilitada para HADRHADR-enabled server instance
Set-SqlAvailabilityGroupSet-SqlAvailabilityGroup Establece las propiedades de un grupo de disponibilidad; poner en línea o sin conexión un grupo de disponibilidadSets the properties of an availability group; take an availability group online/offline Instancia del servidor que hospeda la réplica principalServer instance that hosts primary replica
Switch-SqlAvailabilityGroupSwitch-SqlAvailabilityGroup Inicia una de las siguientes formas de conmutación por errorInitiates one of the following forms of failover:

Una conmutación por error forzada de un grupo de disponibilidad (con posible pérdida de datos).A forced failover of an availability group (with possible data loss).

Una conmutación por error manual de un grupo de disponibilidad.A manual failover of an availability group.
Instancia del servidor que hospeda la réplica secundaria de destinoServer instance that hosts target secondary replica

Crear y administrar un agente de escucha del grupo de disponibilidadCreating and Managing an Availability Group Listener

CmdletCmdlet DescripciónDescription Se admite enSupported on
New-SqlAvailabilityGroupListenerNew-SqlAvailabilityGroupListener Crea un nuevo agente de escucha del grupo de disponibilidad y lo adjunta a un grupo de disponibilidad existente.Creates a new availability group listener and attaches it to an existing availability group. Instancia del servidor que hospeda la réplica principalServer instance that hosts primary replica
Set-SqlAvailabilityGroupListenerSet-SqlAvailabilityGroupListener Modifica la configuración del puerto en un agente de escucha del grupo de disponibilidad existente.Modifies the port setting on an existing availability group listener. Instancia del servidor que hospeda la réplica principalServer instance that hosts primary replica
Add-SqlAvailabilityGroupListenerStaticIpAdd-SqlAvailabilityGroupListenerStaticIp Agrega una dirección IP estática a una configuración de agente de escucha del grupo de disponibilidad existente.Adds a static IP address to an existing availability group listener configuration. La dirección IP estática puede ser una dirección IPv4 con subred o una dirección IPv6.The IP address can be an IPv4 address with subnet, or an IPv6 address. Instancia del servidor que hospeda la réplica principalServer instance that hosts primary replica

Crear y administrar una réplica de disponibilidadCreating and Managing an Availability Replica

CmdletsCmdlets DescripciónDescription Se admite enSupported on
New-SqlAvailabilityReplicaNew-SqlAvailabilityReplica Crea una nueva réplica de disponibilidad.Creates a new availability replica. Puede usar el parámetro -AsTemplate para crear un objeto de réplica de disponibilidad en memoria para cada nueva réplica de disponibilidad.You can Use the -AsTemplate parameter to create an in-memory availability-replica object for each new availability replica. Instancia del servidor que hospeda la réplica principalServer instance that hosts primary replica
Join-SqlAvailabilityGroupJoin-SqlAvailabilityGroup Combina una réplica secundaria con el grupo de disponibilidad.Joins a secondary replica to the availability group. Instancia del servidor que hospeda la réplica secundariaServer instance that hosts secondary replica
Remove-SqlAvailabilityReplicaRemove-SqlAvailabilityReplica Elimina una réplica de disponibilidad.Deletes an availability replica. Instancia del servidor que hospeda la réplica principalServer instance that hosts primary replica
Set-SqlAvailabilityReplicaSet-SqlAvailabilityReplica Establece las propiedades de una réplica de disponibilidad.Sets the properties of an availability replica. Instancia del servidor que hospeda la réplica principalServer instance that hosts primary replica

Agregar y administrar una base de datos de disponibilidadAdding and Managing an Availability Database

CmdletsCmdlets DescripciónDescription Se admite enSupported on
Add-SqlAvailabilityDatabaseAdd-SqlAvailabilityDatabase En la réplica principal, agrega una base de datos a un grupo de disponibilidad.On the primary replica, adds a database to an availability group.

En una réplica secundaria, une una base de datos secundaria a un grupo de disponibilidad.On a secondary replica, joins a secondary database to an availability group.
Cualquier instancia del servidor que hospeda una réplica de disponibilidad (el comportamiento difiere entre las réplicas principal y secundaria)Any server instance that hosts an availability replica (behavior differs for primary and secondary replicas)
Remove-SqlAvailabilityDatabaseRemove-SqlAvailabilityDatabase En la réplica principal, quita del grupo de disponibilidad la base de datos.On the primary replica, removes the database from the availability group.

En una réplica secundaria, quita la base de datos secundaria local de la réplica secundaria local.On a secondary replica, removes the local secondary database from the local secondary replica.
Cualquier instancia del servidor que hospeda una réplica de disponibilidad (el comportamiento difiere entre las réplicas principal y secundaria)Any server instance that hosts an availability replica (behavior differs for primary and secondary replicas)
Resume-SqlAvailabilityDatabaseResume-SqlAvailabilityDatabase Reanuda el movimiento de datos en una base de datos de disponibilidad suspendida.Resumes the data movement for a suspended availability database. La instancia de servidor en la que se ha suspendido la base de datos.The server instance on which the database was suspended.
Suspend-SqlAvailabilityDatabaseSuspend-SqlAvailabilityDatabase Suspende el movimiento de datos en una base de datos de disponibilidad.Suspends the data movement for an availability database. Cualquier instancia de servidor que hospeda una réplica de disponibilidad.Any server instance that hosts an availability replica.

Monitoring Availability Group HealthMonitoring Availability Group Health

Los cmdlets siguientes de SQL ServerSQL Server permiten supervisar el estado de un grupo de disponibilidad y sus réplicas y bases de datos.The following SQL ServerSQL Server cmdlets enable you to monitor the health of an availability group and its replicas and databases.

Importante

Debe tener permisos CONNECT, VIEW SERVER STATE y VIEW ANY DEFINITION para ejecutar estos cmdlets.You must have CONNECT, VIEW SERVER STATE, and VIEW ANY DEFINITION permissions to execute these cmdlets.

CmdletCmdlet DescripciónDescription Se admite enSupported on
Test-SqlAvailabilityGroupTest-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.Assesses the health of an availability group by evaluating SQL Server policy based management (PBM) policies. Cualquier instancia de servidor que hospeda una réplica de disponibilidad.*Any server instance that hosts an availability replica.*
Test-SqlAvailabilityReplicaTest-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.Assesses the health of availability replicas by evaluating SQL Server policy based management (PBM) policies. Cualquier instancia de servidor que hospeda una réplica de disponibilidad.*Any server instance that hosts an availability replica.*
Test-SqlDatabaseReplicaStateTest-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.Assesses the health of an availability database on all joined availability replicas by evaluating SQL Server policy based management (PBM) policies. Cualquier instancia de servidor que hospeda una réplica de disponibilidad.*Any server instance that hosts an availability replica.*

*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.*To view information about all of the availability replicas in an availability group, use to the server instance that hosts the primary replica.

Para obtener más información, vea Usar directivas de AlwaysOn para ver el estado de un grupo de disponibilidad (SQL Server).For more information, see Use Always On Policies to View the Health of an Availability Group (SQL Server).

Consulte tambiénSee Also

Información general de los grupos de disponibilidad AlwaysOn (SQL Server) Overview of Always On Availability Groups (SQL Server)
Obtener ayuda de SQL Server PowerShellGet Help SQL Server PowerShell