Compartir a través de

Set-SqlAvailabilityGroup

  • Referencia
Módulo:
SQLPS

Establece la configuración en un grupo de disponibilidad.

Sintaxis

Set-SqlAvailabilityGroup
   [-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
   [-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
   [-HealthCheckTimeout <Int32>]
   [-DatabaseHealthTrigger <Boolean>]
   [[-Path] <String>]
   [-Script]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SqlAvailabilityGroup
   [-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
   [-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
   [-HealthCheckTimeout <Int32>]
   [-DatabaseHealthTrigger <Boolean>]
   [-InputObject] <AvailabilityGroup>
   [-Script]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet Set-SqlAvailabilityGroup modifica la configuración de un grupo de disponibilidad existente en grupos de disponibilidad AlwaysOn. Puede modificar la preferencia de copia de seguridad automatizada, el nivel de condición de error y el tiempo de espera de comprobación de estado. Debe ejecutar este cmdlet en la instancia del servidor que hospeda la réplica principal.

Ejemplos

Ejemplo 1: Cambiar el período de tiempo de espera de comprobación de estado

PS C:\> Set-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MAinAG" -HealthCheckTimeout 120000

Este comando cambia la propiedad de tiempo de espera de comprobación de estado en el grupo de disponibilidad denominado MainAG a 120 000 milisegundos o dos minutos. Si la conmutación automática por error está habilitada, después de este período de tiempo, se inician grupos de disponibilidad AlwaysOn que inician una conmutación automática por error.

Ejemplo 2: Cambiar la preferencia de copia de seguridad automatizada

PS C:\> Set-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG" -AutomatedBackupPreference SecondaryOnly

Este comando cambia la preferencia de copia de seguridad automatizada en el grupo de disponibilidad denominado MainAG para que sea SecondaryOnly. Las copias de seguridad automatizadas de las bases de datos de este grupo de disponibilidad no se producen en la réplica principal. En su lugar, las copias de seguridad automatizadas se producen en la réplica secundaria que tiene la prioridad de copia de seguridad más alta.

Ejemplo 3: Cambio del nivel de condición de error

PS C:\> Set-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG" -FailureConditionLevel OnServerDown

Este comando cambia el nivel de condición de error en el grupo de disponibilidad denominado MainAG para que sea OnServerDown. Si la instancia de servidor que hospeda la réplica principal se queda sin conexión y si la conmutación automática por error está habilitada, los grupos de disponibilidad AlwaysOn inician una conmutación automática por error.

Parámetros

-AutomatedBackupPreference

Especifica la preferencia de copia de seguridad automatizada para el grupo de disponibilidad. Los valores permitidos para este parámetro son los siguientes:

  • Principal. Especifica que las copias de seguridad siempre se producen en la réplica principal. Esta opción admite el uso de características que no están disponibles cuando la copia de seguridad se ejecuta en una réplica secundaria, como copias de seguridad diferenciales.
  • SecondaryOnly. Especifica que las copias de seguridad nunca se realizan en réplicas principales. Si la réplica principal es la única réplica en línea, la copia de seguridad no se produce.
  • Secundaria. Especifica que las copias de seguridad se producen en réplicas secundarias, a menos que la réplica principal sea la única réplica en línea. En ese caso, la copia de seguridad se produce en la réplica principal.
  • Ninguno. Especifica que el estado principal o secundario no se tiene en cuenta al decidir qué réplica realiza copias de seguridad. En su lugar, la prioridad de copia de seguridad y el estado en línea determinan qué réplica realiza las copias de seguridad.
Tipo:AvailabilityGroupAutomatedBackupPreference
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DatabaseHealthTrigger

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-FailureConditionLevel

Especifica el comportamiento de conmutación automática por error del grupo de disponibilidad. Los valores permitidos para este parámetro son los siguientes:

  • OnServerDown. Conmutación por error o reinicio si el servicio SQL Server se detiene.
  • OnServerUnresponsive. Conmutación por error o reinicio si se cumple alguna condición de valor inferior, además de cuando el servicio de SQL Server está conectado al clúster y se supera el umbral HealthCheckTimeout, o si la réplica de disponibilidad actualmente en el rol principal está en estado de error.
  • OnCriticalServerError. Conmutación por error o reinicio si se cumple alguna condición de valor inferior, además de cuando se produce un error de servidor crítico interno, que incluyen una condición de memoria insuficiente, una infracción grave de acceso a escritura o demasiado volcado.
  • OnModerateServerError. Conmutación por error o reinicio si se cumple alguna condición de valor inferior, además de si se produce un error moderado del servidor, que incluye la condición persistente fuera de memoria.
  • OnAnyQualifiedFailureConditions. Conmutación por error o reinicio si se cumple alguna condición de valor inferior, además de si se produce una condición de error apta, que incluye el agotamiento de subprocesos de trabajo del motor y el interbloqueo irrecuperable detectado.
Tipo:AvailabilityGroupFailureConditionLevel
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-HealthCheckTimeout

Especifica el período de tiempo, en milisegundos, después del cual los grupos de disponibilidad AlwaysOn declaran que un servidor que no responde es incorrecto.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InputObject

Especifica el grupo de disponibilidad, como un objeto AvailabilityGroup , que este cmdlet modifica.

Tipo:AvailabilityGroup
Posición:2
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Path

Especifica la ruta de acceso de la base de datos de disponibilidad que modifica el cmdlet. Si no especifica este parámetro, este cmdlet usa la ubicación de trabajo actual.

Tipo:String
Posición:2
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Script

Indica que este cmdlet devuelve un script de Transact-SQL que realiza la tarea que realiza este cmdlet.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False