Set-SqlAvailabilityGroup

Módulo:

SQLServer

Establece la configuración en un grupo de disponibilidad.

Syntax

Set-SqlAvailabilityGroup
   [-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
   [-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
   [-HealthCheckTimeout <Int32>]
   [-DatabaseHealthTrigger <Boolean>]
   [-RequiredSynchronizedSecondariesToCommit <Int32>]
   [[-Path] <String>]
   [-Script]
   [-AccessToken <PSObject>]
   [-TrustServerCertificate]
   [-HostNameInCertificate <String>]
   [-Encrypt <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-SqlAvailabilityGroup
   [-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
   [-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
   [-HealthCheckTimeout <Int32>]
   [-DatabaseHealthTrigger <Boolean>]
   [-RequiredSynchronizedSecondariesToCommit <Int32>]
   [-InputObject] <AvailabilityGroup>
   [-Script]
   [-AccessToken <PSObject>]
   [-TrustServerCertificate]
   [-HostNameInCertificate <String>]
   [-Encrypt <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet Set-SqlAvailabilityGroup modifica la configuración de un grupo de disponibilidad existente en Always On grupos de disponibilidad. 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 segundos o dos minutos. Si la conmutación automática por error está habilitada, después de este período de tiempo, Always On grupos de disponibilidad inicia una conmutación automática por error.

Ejemplo 2: Cambio de 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 MainAGSecondaryOnlycomo . 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: 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 como OnServerDown. Si la instancia del servidor que hospeda la réplica principal se queda sin conexión y si la conmutación automática por error está habilitada, Always On grupos de disponibilidad inicia una conmutación automática por error.

Ejemplo 4: Cambiar el número de secundarias de "SYNCHRONOUS_COMMIT" que deben estar disponibles para que las transacciones se confirmen en la base de datos principal

# Get server and AG
PS C:\> CD 'SQLSERVER:\SQL\some-hostname\Default'
PS SQLSERVER:\SQL\some-hostname\Default> $server = Get-Item $PWD
PS SQLSERVER:\SQL\some-hostname\Default> $ag = $server.AvailabilityGroups[0]
# Alter AG with RequiredCopiesToCommit = 4
PS SQLSERVER:\SQL\some-hostname\Default> $ag | Set-SqlAvailabilityGroup -RequiredSynchronizedSecondariesToCommit 4

Note: an exception will be thrown if the -RequiredSynchronizedSecondariesToCommit parameter is used when
the target server version is SQL Server 2016 or lower.

Parámetros

-AccessToken

Token de acceso que se usa para autenticarse en SQL Server, como alternativa a la autenticación de usuario o contraseña de Windows.

Esto se puede usar, por ejemplo, para conectarse a SQL Azure DB y SQL Azure Managed Instance usar o Service Principal .Managed Identity

El parámetro que se va a usar puede ser una cadena que representa el token o un PSAccessToken objeto tal como se devuelve mediante la ejecución Get-AzAccessToken -ResourceUrl https://database.windows.netde .

Este parámetro es nuevo en la versión 22 del módulo.

Type:	PSObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-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 las 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, no se produce la copia de seguridad.
• 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.

Type:	AvailabilityGroupAutomatedBackupPreference
Accepted values:	Primary, SecondaryOnly, Secondary, None, Unknown
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DatabaseHealthTrigger

Especifica si se debe desencadenar una conmutación automática por error del grupo de disponibilidad si alguna réplica de base de datos de usuario dentro de un grupo de disponibilidad encuentra una condición de error de base de datos.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Encrypt

Tipo de cifrado que se va a usar al conectarse a SQL Server.

Este valor se asigna a la Encrypt propiedad SqlConnectionEncryptOption del objeto SqlConnection del controlador Microsoft.Data.SqlClient.

En la versión 22 del módulo, el valor predeterminado es Optional (por compatibilidad con v21). En la versión 23+ del módulo, el valor predeterminado será "Obligatorio", lo que puede crear un cambio importante para los scripts existentes.

Este parámetro es nuevo en la versión 22 del módulo.

Type:	String
Accepted values:	Mandatory, Optional, Strict
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 interno crítico del servidor, que incluye la condición de memoria insuficiente, una infracción grave del 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, wich incluye una 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.

Type:	AvailabilityGroupFailureConditionLevel
Accepted values:	OnServerDown, OnServerUnresponsive, OnCriticalServerErrors, OnModerateServerErrors, OnAnyQualifiedFailureCondition, Unknown
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HealthCheckTimeout

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HostNameInCertificate

Nombre de host que se va a usar al validar el certificado TLS/SSL de SQL Server. Debe pasar este parámetro si la instancia de SQL Server está habilitada para Forzar cifrado y desea conectarse a una instancia mediante el nombre de host o el nombre corto. Si se omite este parámetro, es necesario pasar el nombre de dominio completo (FQDN) a -ServerInstance para conectarse a una instancia de SQL Server habilitada para forzar el cifrado.

Este parámetro es nuevo en la versión 22 del módulo.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

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

Type:	AvailabilityGroup
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	String
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RequiredSynchronizedSecondariesToCommit

Número de secundarias de confirmación sincrónicas que deben estar disponibles para poder confirmarse en la base de datos principal.

Si una SYNCHRONOUS_COMMIT base de datos secundaria está desconectada de la principal durante algún tiempo, la principal la desvía para ASYNCHRONOUS_COMMIT evitar bloqueos de confirmaciones. Si la base de datos principal deja de estar disponible y el usuario desea conmutar por error a una de estas secundarias, es posible que se produzca una pérdida de datos. Al establecer RequiredSynchronizedSecondariesToCommit en algún número, el usuario puede evitar la pérdida de datos, ya que la principal comenzará a bloquear confirmaciones si se degradan demasiados secundarios a ASYNCHRONOUS_COMMIT.

El valor predeterminado de esta configuración es 0, lo que significa que el principal nunca bloqueará las confirmaciones. Esto es idéntico al comportamiento anterior a SQL Server 2017.

Type:	Int32
Position:	Named
Default value:	0
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Script

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TrustServerCertificate

Indica si el canal se cifrará al pasar la cadena de certificados para validar la confianza.

En la versión 22 del módulo, el valor predeterminado es $true (por compatibilidad con v21). En la versión 23+ del módulo, el valor predeterminado será "$false", que puede crear un cambio importante para los scripts existentes.

Este parámetro es nuevo en la versión 22 del módulo.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

Microsoft.SqlServer.Management.Smo.AvailabilityGroup

Vínculos relacionados

• Join-SqlAvailabilityGroup
• New-SqlAvailabilityGroup
• Remove-SqlAvailabilityGroup
• Switch-SqlAvailabilityGroup
• Test-SqlAvailabilityGroup