Compartilhar via

Set-SqlAvailabilityGroup

  • Referência
Módulo:
SQLPS

Define as configurações em um grupo de disponibilidade.

Sintaxe

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

O cmdlet Set-SqlAvailabilityGroup modifica as configurações em um grupo de disponibilidade existente em Grupos de Disponibilidade AlwaysOn. Você pode modificar a preferência de backup automatizado, o nível de condição de falha e a integridade marcar tempo limite. Você deve executar esse cmdlet na instância de servidor que hospeda o réplica primário.

Exemplos

Exemplo 1: Alterar a integridade marcar período de tempo limite

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

Esse comando altera a integridade marcar propriedade de tempo limite no grupo de disponibilidade chamado MainAG para 120.000 milissegundos ou dois minutos. Se o failover automático estiver habilitado, após esse período de tempo, os Grupos de Disponibilidade AlwaysOn iniciarão um failover automático.

Exemplo 2: alterar a preferência de backup automatizado

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

Esse comando altera a preferência de backup automatizado no grupo de disponibilidade chamado MainAG para ser SecondaryOnly. Os backups automatizados de bancos de dados nesse grupo de disponibilidade não ocorrem no réplica primário. Em vez disso, os backups automatizados ocorrem no réplica secundário que tem a prioridade de backup mais alta.

Exemplo 3: Alterar o nível de condição de falha

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

Esse comando altera o nível de condição de falha no grupo de disponibilidade chamado MainAG para ser OnServerDown. Se a instância de servidor que hospeda o réplica primário ficar offline e se o failover automático estiver habilitado, os Grupos de Disponibilidade AlwaysOn iniciarão um failover automático.

Parâmetros

-AutomatedBackupPreference

Especifica a preferência de backup automatizado para o grupo de disponibilidade. Os valores aceitáveis para esse parâmetro são:

  • Primária. Especifica que os backups sempre ocorrem no réplica primário. Essa opção dá suporte ao uso de recursos não disponíveis quando o backup é executado em um réplica secundário, como backups diferenciais.
  • SecondaryOnly. Especifica que os backups nunca são executados em réplicas primárias. Se o réplica primário for o único réplica online, o backup não ocorrerá.
  • Secundário. Especifica que os backups ocorrem em réplicas secundárias, a menos que o réplica primário seja o único réplica online. Em seguida, o backup ocorre na réplica primária.
  • Nenhum. Especifica que o status primário ou secundário não é levado em conta ao decidir qual réplica executa backups. Em vez disso, a prioridade de backup e as status online determinam qual réplica executa backups.
Tipo:AvailabilityGroupAutomatedBackupPreference
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DatabaseHealthTrigger

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-FailureConditionLevel

Especifica o comportamento de failover automático do grupo de disponibilidade. Os valores aceitáveis para esse parâmetro são:

  • OnServerDown. Faça failover ou reinicie se o serviço SQL Server for interrompido.
  • OnServerUnresponsive. Failover ou reinicialização se qualquer condição de valor inferior for atendida, além de quando o serviço SQL Server estiver conectado ao cluster e o limite healthCheckTimeout for excedido ou se a disponibilidade réplica atualmente na função primária estiver em um estado de falha.
  • OnCriticalServerError. Failover ou reinicialização se qualquer condição de valor inferior for atendida, além de quando ocorrer um erro de servidor crítico interno, que inclui condição de memória insuficiente, violação grave de acesso de gravação ou muito despejo.
  • OnModerateServerError. Failover ou reinicialização se qualquer condição de valor inferior for atendida, além de ocorrer um erro moderado do Servidor, o que inclui condição persistente de memória insuficiente.
  • OnAnyQualifiedFailureConditions. Failover ou reinicialização se qualquer condição de valor inferior for atendida, além de ocorrer uma condição de falha qualificada, que inclui esgotamento de thread de trabalho do mecanismo e deadlock insolúvel detectado.
Tipo:AvailabilityGroupFailureConditionLevel
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-HealthCheckTimeout

Especifica o período de tempo, em milissegundos, após o qual os Grupos de Disponibilidade AlwaysOn declaram um servidor sem resposta como não íntegro.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Especifica o grupo de disponibilidade, como um objeto AvailabilityGroup , que este cmdlet modifica.

Tipo:AvailabilityGroup
Cargo:2
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Path

Especifica o caminho do banco de dados de disponibilidade que o cmdlet modifica. Se você não especificar esse parâmetro, esse cmdlet usará o local de trabalho atual.

Tipo:String
Cargo:2
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Script

Indica que esse cmdlet retorna um script Transact-SQL que executa a tarefa que este cmdlet executa.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False