Set-SqlAvailabilityGroup
Define as configurações em um grupo de disponibilidade.
Sintaxe
Set-SqlAvailabilityGroup
[-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
[-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
[-HealthCheckTimeout <Int32>]
[-DatabaseHealthTrigger <Boolean>]
[-RequiredSynchronizedSecondariesToCommit <Int32>]
[[-Path] <String>]
[-Script]
[-AccessToken <PSObject>]
[-TrustServerCertificate]
[-HostNameInCertificate <String>]
[-Encrypt <String>]
[-ProgressAction <ActionPreference>]
[-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>]
[-ProgressAction <ActionPreference>]
[-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 o tempo limite de verificação de integridade. Você deve executar esse cmdlet na instância do servidor que hospeda a réplica primária.
Exemplos
Exemplo 1: alterar o período de tempo limite de verificação de integridade
PS C:\> Set-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MAinAG" -HealthCheckTimeout 120000Esse comando altera a propriedade de tempo limite de verificação de integridade no grupo de disponibilidade denominado MainAG para 120 segundos 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 SecondaryOnlyEsse comando altera a preferência de backup automatizado no grupo de disponibilidade denominado MainAG para ser SecondaryOnly.
Backups automatizados de bancos de dados neste grupo de disponibilidade não ocorrem na réplica primária.
Em vez disso, os backups automatizados ocorrem na réplica secundária 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 OnServerDownEsse comando altera o nível de condição de falha no grupo de disponibilidade denominado MainAG a ser OnServerDown.
Se a instância do servidor que hospeda a réplica primária ficar offline e se o failover automático estiver habilitado, os Grupos de Disponibilidade AlwaysOn iniciarão um failover automático.
Exemplo 4: alterar o número de secundários 'SYNCHRONOUS_COMMIT' que devem estar disponíveis para que as transações sejam confirmadas no primário
# 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
O token de acesso usado para autenticar no SQL Server, como uma alternativa ao usuário/senha ou à Autenticação do Windows.
Isso pode ser usado, por exemplo, para se conectar a SQL Azure DB e SQL Azure Managed Instance usando um Service Principal ou um Managed Identity.
O parâmetro a ser usado pode ser uma cadeia de caracteres que representa o token ou um objeto PSAccessToken conforme retornado executando Get-AzAccessToken -ResourceUrl https://database.windows.net.
Esse parâmetro é novo na v22 do módulo.
| Tipo: | PSObject |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-AutomatedBackupPreference
Especifica a preferência de backup automatizado para o grupo de disponibilidade. Os valores aceitáveis para este parâmetro são:
- Primário. Especifica que os backups sempre ocorrem na réplica primária. Essa opção dá suporte ao uso de recursos não disponíveis quando o backup é executado em uma réplica secundária, como backups diferenciais.
- SecondaryOnly. Especifica que os backups nunca são executados em réplicas primárias. Se a réplica primária for a única réplica online, o backup não ocorrerá.
- Secundário. Especifica que os backups ocorrem em réplicas secundárias, a menos que a réplica primária seja a única 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 o status online determinam qual réplica executa backups.
| Tipo: | AvailabilityGroupAutomatedBackupPreference |
| Valores aceitos: | Primary, SecondaryOnly, Secondary, None, Unknown |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Confirm
Solicita a 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
Especifica se um failover automático do grupo de disponibilidade deve ser disparado se qualquer réplica de banco de dados de usuário em um grupo de disponibilidade encontrar uma condição de falha de banco de dados.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Encrypt
O tipo de criptografia a ser usado ao se conectar ao SQL Server.
Esse valor é mapeado para a propriedade EncryptSqlConnectionEncryptOption no objeto SqlConnection do driver Microsoft.Data.SqlClient.
Na v22 do módulo, o padrão é Optional (para compatibilidade com v21). Na v23+ do módulo, o valor padrão será 'Obrigatório', o que pode criar uma alteração significativa para scripts existentes.
Esse parâmetro é novo na v22 do módulo.
| Tipo: | String |
| Valores aceitos: | Mandatory, Optional, Strict |
| 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 este parâmetro são:
- OnServerDown. Failover ou reinicialização se o serviço do SQL Server for interrompido.
- OnServerUnresponsive. Failover ou reinicialização se qualquer condição de valor inferior for atendida, mais quando o serviço SQL Server estiver conectado ao cluster e o HealthCheckTimeout limite for excedido ou se a réplica de disponibilidade 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 incluem 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 disso, se ocorrer um erro moderado do servidor, isso inclui a condição persistente fora da memória.
- OnAnyQualifiedFailureConditions. Failover ou reinicialização se qualquer condição de valor inferior for atendida, além disso, se ocorrer uma condição de falha qualificada, que inclui esgotamento de thread de trabalho do mecanismo e deadlock insolúvel detectado.
| Tipo: | AvailabilityGroupFailureConditionLevel |
| Valores aceitos: | OnServerDown, OnServerUnresponsive, OnCriticalServerErrors, OnModerateServerErrors, OnAnyQualifiedFailureCondition, Unknown |
| 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 que um servidor sem resposta não está íntegro.
| Tipo: | Int32 |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-HostNameInCertificate
O nome do host a ser usado na validação do certificado TLS/SSL do SQL Server. Você deve passar esse parâmetro se a instância do SQL Server estiver habilitada para o Force Encryption e quiser se conectar a uma instância usando nome de host/nome curto. Se esse parâmetro for omitido, passar o FQDN (Nome de Domínio Totalmente Qualificado) para -ServerInstance será necessário para se conectar a uma instância do SQL Server habilitada para o Force Encryption.
Esse parâmetro é novo na v22 do módulo.
| Tipo: | String |
| 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 esse cmdlet modifica.
| Tipo: | AvailabilityGroup |
| Cargo: | 1 |
| 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: | 1 |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ProgressAction
Determina como o PowerShell responde às atualizações de progresso geradas por um script, cmdlet ou provedor, como as barras de progresso geradas pelo cmdlet Write-Progress. O cmdlet Write-Progress cria barras de progresso que mostram o status de um comando.
| Tipo: | ActionPreference |
| Aliases: | proga |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-RequiredSynchronizedSecondariesToCommit
O número de secundários de confirmação síncrona que devem estar disponíveis para serem confirmados no primário.
Se um SYNCHRONOUS_COMMIT secundário for desconectado do primário por algum tempo, o primário o rebaixará para ASYNCHRONOUS_COMMIT para evitar o bloqueio de confirmações. Se o primário ficar indisponível e o usuário desejar fazer failover para um desses secundários, ele poderá incorrer em perda de dados. Ao definir RequiredSynchronizedSecondariesToCommit para algum número, o usuário pode evitar a perda de dados, pois o primário começará a bloquear confirmações se muitos secundários forem rebaixados para ASYNCHRONOUS_COMMIT.
O valor padrão dessa configuração é 0, o que significa que o primário nunca bloqueará confirmações. Isso é idêntico ao comportamento anterior ao SQL Server 2017.
| Tipo: | Int32 |
| Cargo: | Named |
| Valor padrão: | 0 |
| 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 executada por esse cmdlet.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-TrustServerCertificate
Indica se o canal será criptografado ao ignorar a cadeia de certificados para validar a confiança.
Na v22 do módulo, o padrão é $true (para compatibilidade com v21). Na v23+ do módulo, o valor padrão será "$false", o que pode criar uma alteração significativa para scripts existentes.
Esse parâmetro é novo na v22 do módulo.
| 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 |
Entradas
Microsoft.SqlServer.Management.Smo.AvailabilityGroup
Links Relacionados
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de