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