Freigeben über

Set-SqlAvailabilityGroup

Modul:
SQLPS Module

Legt Einstellungen für eine Verfügbarkeitsgruppe fest.

Syntax

ByPath (Standardwert) 

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

Beschreibung

Das Cmdlet Set-SqlAvailabilityGroup ändert Einstellungen für eine vorhandene Verfügbarkeitsgruppe in AlwaysOn-Verfügbarkeitsgruppen. Sie können die automatische Sicherungseinstellung, die Fehlerbedingungsebene und das Timeout der Integritätsprüfung ändern. Sie müssen dieses Cmdlet auf der Serverinstanz ausführen, die das primäre Replikat hosten soll.

Beispiele

Beispiel 1: Ändern des Timeoutzeitraums für die Integritätsprüfung

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

Mit diesem Befehl wird die Timeouteigenschaft für die Integritätsprüfung für die Verfügbarkeitsgruppe mit dem Namen "MainAG" auf 120.000 Millisekunden oder zwei Minuten geändert. Wenn das automatische Failover aktiviert ist, wird nach dieser Zeitspanne AlwaysOn-Verfügbarkeitsgruppen ein automatisches Failover initiiert.

Beispiel 2: Ändern der automatischen Sicherungseinstellung

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

Mit diesem Befehl wird die automatische Sicherungseinstellung für die Verfügbarkeitsgruppe "MainAG" in "SecondaryOnly" geändert. Automatisierte Sicherungen von Datenbanken in dieser Verfügbarkeitsgruppe treten nicht im primären Replikat auf. Stattdessen treten automatisierte Sicherungen auf dem sekundären Replikat auf, das die höchste Sicherungspriorität aufweist.

Beispiel 3: Ändern der Fehlerbedingungsstufe

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

Mit diesem Befehl wird die Fehlerbedingungsebene der Verfügbarkeitsgruppe "MainAG" in "OnServerDown" geändert. Wenn die Serverinstanz, die das primäre Replikat hostt, offline und wenn das automatische Failover aktiviert ist, startet AlwaysOn-Verfügbarkeitsgruppen ein automatisches Failover.

Parameter

-AutomatedBackupPreference

Gibt die automatische Sicherungseinstellung für die Verfügbarkeitsgruppe an. Die zulässigen Werte für diesen Parameter sind:

  • Primär. Gibt an, dass die Sicherungen immer im primären Replikat auftreten. Diese Option unterstützt die Verwendung von Features, die nicht verfügbar sind, wenn die Sicherung auf einem sekundären Replikat ausgeführt wird, z. B. differenzielle Sicherungen.
  • SecondaryOnly. Gibt an, dass Sicherungen nie für primäre Replikate ausgeführt werden. Wenn das primäre Replikat das einzige Onlinereplikat ist, tritt die Sicherung nicht auf.
  • Sekundär. Gibt an, dass Sicherungen auf sekundären Replikaten auftreten, es sei denn, das primäre Replikat ist das einzige Replikat online. Anschließend tritt die Sicherung auf dem primären Replikat auf.
  • Keiner. Gibt an, dass der primäre oder sekundäre Status bei der Entscheidung, welches Replikat Sicherungen ausführt, nicht berücksichtigt wird. Stattdessen bestimmen die Sicherungspriorität und der Onlinestatus, welches Replikat Sicherungen ausführt.

Parametereigenschaften

Typ:AvailabilityGroupAutomatedBackupPreference
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DatabaseHealthTrigger

Das Cmdlet Set-SqlAvailabilityGroup ändert Einstellungen für eine vorhandene Verfügbarkeitsgruppe in AlwaysOn-Verfügbarkeitsgruppen. Sie können die automatische Sicherungseinstellung, die Fehlerbedingungsebene und das Timeout der Integritätsprüfung ändern. Sie müssen dieses Cmdlet auf der Serverinstanz ausführen, die das primäre Replikat hosten soll.

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-FailureConditionLevel

Gibt das automatische Failoververhalten der Verfügbarkeitsgruppe an. Die zulässigen Werte für diesen Parameter sind:

  • OnServerDown. Failover oder Neustart, wenn der SQL Server-Dienst beendet wird.
  • OnServerUnresponsive. Failover oder Neustart, wenn eine Bedingung niedrigerer Werte erfüllt ist, plus wenn der SQL Server-Dienst mit dem Cluster verbunden ist und der HealthCheckTimeout-Schwellenwert überschritten wird oder wenn das Verfügbarkeitsreplikat, das sich derzeit in der primären Rolle befindet, in einem fehlerhaften Zustand ist.
  • OnCriticalServerError. Failover oder Neustart, wenn eine Bedingung mit einem niedrigeren Wert erfüllt ist, und wenn ein interner kritischer Serverfehler auftritt, einschließlich des Arbeitsspeicherzustands, schwerwiegender Schreibzugriffsverletzung oder zu viel Dumping.
  • OnModerateServerError. Failover oder Neustart, wenn eine Bedingung niedrigeren Werts erfüllt ist, und wenn ein moderater Serverfehler auftritt, enthält wich wich persistenten Zustand außerhalb des Arbeitsspeichers.
  • OnAnyQualifiedFailureConditions. Failover oder Neustart, wenn eine Bedingung mit niedrigerem Wert erfüllt ist, und wenn eine qualifizierende Fehlerbedingung auftritt, einschließlich der Threadausschöpfung des Modul-Workers und der nicht aufgelösten Deadlock erkannt.

Parametereigenschaften

Typ:AvailabilityGroupFailureConditionLevel
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-HealthCheckTimeout

Gibt die Zeitdauer in Millisekunden an, nach der AlwaysOn-Verfügbarkeitsgruppen einen nicht reagierenden Server als fehlerhafter Server deklarieren.

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-InputObject

Gibt die Verfügbarkeitsgruppe als AvailabilityGroup-Objekt an, die dieses Cmdlet ändert.

Parametereigenschaften

Typ:AvailabilityGroup
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByObject
Position:2
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Path

Gibt den Pfad der Verfügbarkeitsdatenbank an, die vom Cmdlet geändert wird. Wenn Sie diesen Parameter nicht angeben, verwendet dieses Cmdlet den aktuellen Arbeitsort.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByPath
Position:2
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Script

Gibt an, dass dieses Cmdlet ein Transact-SQL Skript zurückgibt, das die aufgabe ausführt, die dieses Cmdlet ausführt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.