Set-SqlAvailabilityGroup

  • Riferimento
Modulo:
SQLServer

Imposta le impostazioni in un gruppo di disponibilità.

Sintassi

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>]

Descrizione

Il cmdlet Set-SqlAvailabilityGroup modifica le impostazioni in un gruppo di disponibilità esistente in Always On gruppi di disponibilità. È possibile modificare le preferenze di backup automatizzate, il livello di condizione di errore e il timeout del controllo integrità. È necessario eseguire questo cmdlet nell'istanza del server che ospita la replica primaria.

Esempio

Esempio 1: Modificare il periodo di timeout del controllo integrità

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

Questo comando modifica la proprietà di timeout del controllo integrità nel gruppo di disponibilità denominata MainAG in 120 secondi o due minuti. Se il failover automatico è abilitato, dopo questo periodo di tempo, Always On gruppi di disponibilità avvia un failover automatico.

Esempio 2: Modificare le preferenze di backup automatizzate

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

Questo comando modifica la preferenza di backup automatizzato nel gruppo di disponibilità denominato MainAG come SecondaryOnly. I backup automatici dei database in questo gruppo di disponibilità non vengono eseguiti nella replica primaria. I backup automatizzati vengono invece eseguiti nella replica secondaria con la priorità di backup più alta.

Esempio 3: Modificare il livello di condizione di errore

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

Questo comando modifica il livello di condizione di errore nel gruppo di disponibilità denominato MainAG come OnServerDown. Se l'istanza del server che ospita la replica primaria passa offline e se il failover automatico è abilitato, Always On gruppi di disponibilità avvia un failover automatico.

Esempio 4: Modificare il numero di database secondari 'SYNCHRONOUS_COMMIT' che devono essere disponibili per il commit delle transazioni nel database primario

# 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.

Parametri

-AccessToken

Token di accesso usato per eseguire l'autenticazione per SQL Server, in alternativa all'autenticazione utente/password o Windows.

Può essere usato, ad esempio, per connettersi a SQL Azure DB e SQL Azure Managed Instance usando un Service Principal oggetto o .Managed Identity

Il parametro da usare può essere una stringa che rappresenta il token o un PSAccessToken oggetto restituito eseguendo Get-AzAccessToken -ResourceUrl https://database.windows.net.

Questo parametro è nuovo nella versione 22 del modulo.

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

-AutomatedBackupPreference

Specifica la preferenza di backup automatizzata per il gruppo di disponibilità. I valori validi per questo parametro sono:

  • Primario. Specifica che i backup vengono sempre eseguiti nella replica primaria. Questa opzione supporta l'uso di funzionalità non disponibili quando il backup viene eseguito in una replica secondaria, ad esempio backup differenziali.
  • SecondaryOnly. Specifica che i backup non vengono mai eseguiti nelle repliche primarie. Se la replica primaria è l'unica replica online, il backup non viene eseguito.
  • Secondario. Specifica che i backup vengono eseguiti nelle repliche secondarie, a meno che la replica primaria non sia l'unica replica online. Successivamente, il backup viene eseguito nella replica primaria.
  • Nessuno. Specifica che lo stato primario o secondario non viene preso in considerazione quando si decide quale replica esegue i backup. Al contrario, la priorità di backup e lo stato online determinano quali repliche eseguono backup.
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

Richiede la conferma dell'utente prima di eseguire il cmdlet.

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

-DatabaseHealthTrigger

Specifica se attivare un failover automatico del gruppo di disponibilità se una replica di database utente all'interno di un gruppo di disponibilità rileva una condizione di errore del database.

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

-Encrypt

Tipo di crittografia da utilizzare per la connessione a SQL Server.

Questo valore esegue il Encrypt mapping alla proprietà SqlConnectionEncryptOption nell'oggetto SqlConnection del driver Microsoft.Data.SqlClient.

Nella versione 22 del modulo il valore predefinito è Optional (per compatibilità con la versione 21). Nella versione 23+ del modulo il valore predefinito sarà "Obbligatorio", che può creare una modifica di rilievo per gli script esistenti.

Questo parametro è nuovo nella versione 22 del modulo.

Type:String
Accepted values:Mandatory, Optional, Strict
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FailureConditionLevel

Specifica il comportamento di failover automatico del gruppo di disponibilità. I valori validi per questo parametro sono:

  • OnServerDown. Failover o riavvio se il servizio SQL Server si arresta.
  • OnServerUnresponsive. Failover o riavvio se viene soddisfatta una condizione di valore inferiore, oltre a quando il servizio SQL Server è connesso al cluster e viene superata la soglia HealthCheckTimeout oppure se la replica di disponibilità attualmente nel ruolo primario si trova in uno stato di errore.
  • OnCriticalServerError. Failover o riavvio se viene soddisfatta una condizione di valore inferiore, oltre a quando si verifica un errore interno critico del server, che include una condizione di memoria insufficiente, una grave violazione dell'accesso in scrittura o un dump eccessivo.
  • OnModerateServerError. Failover o riavvio se viene soddisfatta una condizione di valore inferiore, più se si verifica un errore moderato del server, il quale include una condizione persistente di memoria insufficiente.
  • OnAnyQualifiedFailureConditions. Failover o riavvio se viene soddisfatta una condizione di valore inferiore, più se si verifica una condizione di errore idonea, che include l'esaurimento del thread di lavoro del motore e il deadlock non risolvibile rilevato.
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

Specifica il periodo di tempo, espresso in millisecondi, dopo il quale Always On gruppi di disponibilità dichiara che un server non risponde non integro.

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

-HostNameInCertificate

Nome host da usare per la convalida del certificato TLS/SSL di SQL Server. È necessario passare questo parametro se l'istanza di SQL Server è abilitata per Forza crittografia e si vuole connettersi a un'istanza usando nome host/nome breve. Se questo parametro viene omesso, è necessario passare il nome di dominio completo (FQDN) a -ServerInstance per connettersi a un'istanza di SQL Server abilitata per Forza crittografia.

Questo parametro è nuovo nella versione 22 del modulo.

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

-InputObject

Specifica il gruppo di disponibilità, come oggetto AvailabilityGroup, che questo cmdlet modifica.

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

-Path

Specifica il percorso del database di disponibilità modificato dal cmdlet. Se non si specifica questo parametro, questo cmdlet usa la posizione di lavoro corrente.

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

-RequiredSynchronizedSecondariesToCommit

Numero di repliche secondarie di commit sincrono che devono essere disponibili per poter eseguire il commit nel database primario.

Se un SYNCHRONOUS_COMMIT database secondario viene disconnesso dal database primario per un certo periodo di tempo, il database primario lo abbassa per ASYNCHRONOUS_COMMIT evitare il blocco dei commit. Se il database primario diventa quindi non disponibile e l'utente vuole eseguire il failover in uno di questi database secondari, può comportare una perdita di dati. Impostando RequiredSynchronizedSecondariesToCommit su un numero, l'utente può impedire la perdita di dati perché il database primario inizierà a bloccare i commit se troppi database secondari vengono abbassati di livello su ASYNCHRONOUS_COMMIT.

Il valore predefinito di questa impostazione è 0, il che significa che il database primario non bloccherà mai i commit. Questo comportamento è identico a quello precedente SQL Server 2017.

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

-Script

Indica che questo cmdlet restituisce uno script Transact-SQL che esegue l'attività eseguita da questo cmdlet.

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

-TrustServerCertificate

Indica se il canale verrà crittografato durante il bypass della catena di certificati per convalidare l'attendibilità.

Nella versione 22 del modulo il valore predefinito è $true (per compatibilità con la versione 21). Nella versione 23+ del modulo il valore predefinito sarà "$false", che può creare una modifica di rilievo per gli script esistenti.

Questo parametro è nuovo nella versione 22 del modulo.

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

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.

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

Input

Microsoft.SqlServer.Management.Smo.AvailabilityGroup