Condividi tramite

Set-SqlAvailabilityGroup

Modulo:
SQLPS Module

Imposta le impostazioni in un gruppo di disponibilità.

Sintassi

ByPath (impostazione predefinita). 

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

Descrizione

Il cmdlet Set-SqlAvailabilityGroup modifica le impostazioni in un gruppo di disponibilità esistente nei gruppi di disponibilità AlwaysOn. È 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à timeout controllo integrità nel gruppo di disponibilità denominato MainAG a 120.000 millisecondi o due minuti. Se il failover automatico è abilitato, dopo questo periodo di tempo, i gruppi di disponibilità AlwaysOn avviano 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 le preferenze di backup automatizzate nel gruppo di disponibilità denominato MainAG in 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 in modo che sia OnServerDown. Se l'istanza del server che ospita la replica primaria diventa offline e, se il failover automatico è abilitato, i gruppi di disponibilità AlwaysOn avviano un failover automatico.

Parametri

-AutomatedBackupPreference

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

  • Primario. Specifica che i backup vengono sempre eseguiti nella replica primaria. Questa opzione supporta l'uso di funzionalità non disponibili durante l'esecuzione del backup 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. Il backup viene quindi 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.

Proprietà dei parametri

Tipo:AvailabilityGroupAutomatedBackupPreference
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DatabaseHealthTrigger

Il cmdlet Set-SqlAvailabilityGroup modifica le impostazioni in un gruppo di disponibilità esistente nei gruppi di disponibilità AlwaysOn. È 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.

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-FailureConditionLevel

Specifica il comportamento di failover automatico del gruppo di disponibilità. I valori accettabili 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 è in 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 includono 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, che include una condizione persistente di memoria insufficiente.
  • OnAnyQualifiedFailureConditions. Failover o riavvio se viene soddisfatta una condizione di valore inferiore, oltre a se si verifica una condizione di errore idonea, che include l'esaurimento del thread di lavoro del motore e il deadlock non risolvibile rilevato.

Proprietà dei parametri

Tipo:AvailabilityGroupFailureConditionLevel
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-HealthCheckTimeout

Specifica il periodo di tempo, espresso in millisecondi, dopo il quale i gruppi di disponibilità AlwaysOn dichiarano che un server non risponde non integro.

Proprietà dei parametri

Tipo:Int32
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-InputObject

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

Proprietà dei parametri

Tipo:AvailabilityGroup
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ByObject
Posizione:2
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ByPath
Posizione:2
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Script

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.