Freigeben über

Set-SqlAvailabilityGroup

  • Referenz
Modul:
SQLServer

Legt Einstellungen für eine Verfügbarkeitsgruppe fest.

Syntax

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

Beschreibung

Mit dem Cmdlet Set-SqlAvailabilityGroup-Cmdlet werden Einstellungen für eine vorhandene Verfügbarkeitsgruppe in AlwaysOn-Verfügbarkeitsgruppen geändert. 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 in der Verfügbarkeitsgruppe mit dem Namen MainAG in 120 Sekunden 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 einstellung für die automatische Sicherung in der Verfügbarkeitsgruppe mit dem Namen MainAG geändert, um SecondaryOnlyzu werden. 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 mit dem Namen MainAG geändert, um OnServerDownzu werden. Wenn die Serverinstanz, die das primäre Replikat hostt, offline und wenn das automatische Failover aktiviert ist, startet AlwaysOn-Verfügbarkeitsgruppen ein automatisches Failover.

Beispiel 4: Ändern der Anzahl der "SYNCHRONOUS_COMMIT"-Secondärdateien, die für Transaktionen verfügbar sein müssen, um sich für den primären Commit zu verpflichten

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

Parameter

-AccessToken

Das Zugriffstoken, das zur Authentifizierung bei SQL Server verwendet wird, als Alternative zur Benutzer-/Kennwort- oder Windows-Authentifizierung.

Dies kann z. B. zum Herstellen einer Verbindung mit SQL Azure DB und SQL Azure Managed Instance mithilfe eines Service Principal oder einer Managed Identityverwendet werden.

Der zu verwendende Parameter kann entweder eine Zeichenfolge sein, die das Token darstellt, oder ein PSAccessToken-Objekt, wie durch Ausführen von Get-AzAccessToken -ResourceUrl https://database.windows.netzurückgegeben wird.

Dieser Parameter ist neu in v22 des Moduls.

Typ:PSObject
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-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.
  • Nichts. 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.
Typ:AvailabilityGroupAutomatedBackupPreference
Zulässige Werte:Primary, SecondaryOnly, Secondary, None, Unknown
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DatabaseHealthTrigger

Gibt an, ob ein automatisches Failover der Verfügbarkeitsgruppe ausgelöst werden soll, wenn ein Benutzerdatenbankreplikat innerhalb einer Verfügbarkeitsgruppe auf eine Datenbankfehlerbedingung stößt.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Encrypt

Der Verschlüsselungstyp, der beim Herstellen einer Verbindung mit SQL Server verwendet werden soll.

Dieser Wert ist der Encrypt Eigenschaft SqlConnectionEncryptOption für das SqlConnection-Objekt des Microsoft.Data.SqlClient-Treibers zugeordnet.

In v22 des Moduls ist die Standardeinstellung Optional (aus Kompatibilität mit v21). In v23+ des Moduls lautet der Standardwert "Verpflichtend", wodurch für vorhandene Skripts eine bahnbrechende Änderung erstellt werden kann.

Dieser Parameter ist neu in v22 des Moduls.

Typ:String
Zulässige Werte:Mandatory, Optional, Strict
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.
Typ:AvailabilityGroupFailureConditionLevel
Zulässige Werte:OnServerDown, OnServerUnresponsive, OnCriticalServerErrors, OnModerateServerErrors, OnAnyQualifiedFailureCondition, Unknown
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-HealthCheckTimeout

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

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-HostNameInCertificate

Der Hostname, der beim Überprüfen des SQL Server TLS/SSL-Zertifikats verwendet werden soll. Sie müssen diesen Parameter übergeben, wenn Ihre SQL Server-Instanz für die Erzwingungsverschlüsselung aktiviert ist und Sie eine Verbindung mit einer Instanz mit hostname/shortname herstellen möchten. Wenn dieser Parameter nicht angegeben wird, ist das Übergeben des vollqualifizierten Domänennamens (Fully Qualified Domain Name, FQDN) an -ServerInstance erforderlich, um eine Verbindung mit einer SQL Server-Instanz herzustellen, die für die Erzwingungsverschlüsselung aktiviert ist.

Dieser Parameter ist neu in v22 des Moduls.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

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

Typ:AvailabilityGroup
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren: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.

Typ:String
Position:1
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ProgressAction

Bestimmt, wie PowerShell auf Statusaktualisierungen reagiert, die von einem Skript, Cmdlet oder Anbieter generiert werden, z. B. auf die Statusanzeigen, die vom Cmdlet Write-Progress generiert werden. Das Cmdlet Write-Progress erstellt Statusanzeigen, die den Status eines Befehls anzeigen.

Typ:ActionPreference
Aliase:proga
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RequiredSynchronizedSecondariesToCommit

Die Anzahl der synchronen Commit-Secondärdateien, die verfügbar sein müssen, um einen Commit für die primäre Datei ausführen zu können.

Wenn eine sekundäre SYNCHRONOUS_COMMIT seit einiger Zeit von der primären Getrennt ist, wird sie von der primären zu ASYNCHRONOUS_COMMIT herabgestuft, um Blockierungs-Commits zu vermeiden. Wenn der Primäre dann nicht verfügbar ist und der Benutzer zu einem dieser Secondaries fehlschlagen möchte, kann es zu Datenverlusten kommen. Durch Festlegen RequiredSynchronizedSecondariesToCommit- auf eine bestimmte Zahl kann der Benutzer den Datenverlust verhindern, da der primäre Start mit dem Blockieren von Commits beginnt, wenn zu viele Secondärdateien auf ASYNCHRONOUS_COMMITherabgestuft werden.

Der Standardwert dieser Einstellung ist 0, was bedeutet, dass der primäre Commit nie blockiert wird. Dies ist identisch mit dem Verhalten vor SQL Server 2017.

Typ:Int32
Position:Named
Standardwert:0
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Script

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TrustServerCertificate

Gibt an, ob der Kanal verschlüsselt wird, während die Zertifikatkette umgangen wird, um die Vertrauensstellung zu überprüfen.

In v22 des Moduls ist die Standardeinstellung $true (aus Kompatibilität mit v21). In v23+ des Moduls lautet der Standardwert "$false", wodurch möglicherweise eine änderung für vorhandene Skripts geändert wird.

Dieser Parameter ist neu in v22 des Moduls.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.SqlServer.Management.Smo.AvailabilityGroup