Compartir a través de

Set-SqlAvailabilityGroup

Módulo:
SQLPS Module

Establece la configuración en un grupo de disponibilidad.

Sintaxis

ByPath (Es el valor predeterminado). 

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

ByObject 

Set-SqlAvailabilityGroup
    [-InputObject] <AvailabilityGroup>
    [-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
    [-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
    [-HealthCheckTimeout <Int32>]
    [-DatabaseHealthTrigger <Boolean>]
    [-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 del 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, los grupos de disponibilidad AlwaysOn 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 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: Cambiar el 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 del servidor que hospeda la réplica principal se queda sin conexión y si está habilitada la conmutación automática por error, 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 aceptables para este parámetro son:

  • Primario. 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 las réplicas principales. Si la réplica principal es la única réplica en línea, no se produce la copia de seguridad.
  • Secundario. 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. A continuación, 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.

Propiedades del parámetro

Tipo:AvailabilityGroupAutomatedBackupPreference
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DatabaseHealthTrigger

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.

Propiedades del parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-FailureConditionLevel

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

  • 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 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 incluye una condición de memoria insuficiente, una infracción grave de acceso de 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,wich incluye la condición persistente de memoria insuficiente.
  • 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.

Propiedades del parámetro

Tipo:AvailabilityGroupFailureConditionLevel
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-HealthCheckTimeout

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

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-InputObject

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

Propiedades del parámetro

Tipo:AvailabilityGroup
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ByObject
Posición:2
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ByPath
Posición:2
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Script

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

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

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

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.