Freigeben über

New-SqlAvailabilityGroup

Modul:
SQLPS Module

Erstellt eine Verfügbarkeitsgruppe.

Syntax

ByPath (Standardwert) 

New-SqlAvailabilityGroup
    [-Name] <String>
    [[-Path] <String>]
    -AvailabilityReplica <AvailabilityReplica[]>
    [-Database <String[]>]
    [-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
    [-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
    [-HealthCheckTimeout <Int32>]
    [-BasicAvailabilityGroup]
    [-DatabaseHealthTrigger]
    [-DtcSupportEnabled]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByObject 

New-SqlAvailabilityGroup
    [-Name] <String>
    [-InputObject] <Server>
    -AvailabilityReplica <AvailabilityReplica[]>
    [-Database <String[]>]
    [-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
    [-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
    [-HealthCheckTimeout <Int32>]
    [-BasicAvailabilityGroup]
    [-DatabaseHealthTrigger]
    [-DtcSupportEnabled]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Beschreibung

Das Cmdlet New-SqlAvailabilityGroup erstellt eine Verfügbarkeitsgruppe in AlwaysOn-Verfügbarkeitsgruppen. Der Parameter InputObject oder Path gibt den Server an, auf dem das ursprüngliche primäre Replikat gehostet wird.

Beispiele

Beispiel 1: Erstellen einer Verfügbarkeitsgruppe

PS C:\> $PrimaryServer = Get-Item "SQLSERVER:\SQL\PrimaryServer\Instance22"
PS C:\> $SecondaryServer = Get-Item "SQLSERVER:\SQL\SecondaryServer\Instance22"
PS C:\> $PrimaryReplica = New-SqlAvailabilityReplica -Name "PrimaryServer\Instance22" -EndpointUrl "TCP://PrimaryServer.domain:5022" -FailoverMode "Automatic" -AvailabilityMode "SynchronousCommit" -AsTemplate -Version ($PrimaryServer.Version)
PS C:\> $SecondaryReplica = New-SqlAvailabilityReplica -Name "SecondaryServer\Instance22" -EndpointUrl "TCP://SecondaryServer.domain:5022" -FailoverMode "Automatic" -AvailabilityMode "SynchronousCommit" -AsTemplate -Version ($SecondaryServer.Version)
PS C:\> New-SqlAvailabilityGroup -InputObject $PrimaryServer -Name "MainAG" -AvailabilityReplica ($PrimaryReplica, $SecondaryReplica) -Database @("Database01","Database02")

Der erste Befehl ruft eine Instanz von SQL Server auf dem primären Server ab und speichert sie dann in der $PrimaryServer Variablen.

Der zweite Befehl ruft eine Instanz von SQL Server auf dem sekundären Server ab und speichert sie dann in der variablen $SecondaryServer.

Der dritte Befehl erstellt ein Replikat, das die primäre Serverinstanz mit dem Cmdlet New-SqlAvailabilityReplica enthält, und speichert es dann in der $PrimaryReplica Variablen. Der Befehl gibt die Version der Serverinstanz mithilfe der Version-Eigenschaft von $PrimaryServer an.

Der vierte Befehl erstellt ein Replikat, das die sekundäre Serverinstanz mithilfe von New-SqlAvailabilityReplica enthält, und speichert es dann in der $SecondaryReplica Variablen. Der Befehl gibt die Version der Serverinstanz mithilfe der Version-Eigenschaft von $SecondaryServer an.

Der letzte Befehl erstellt die Verfügbarkeitsgruppe. Er gibt den Namen, den primären Server, die Replikate und andere Informationen an.

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

-AvailabilityReplica

Gibt ein Array von Verfügbarkeitsreplikaten an, die dieses Cmdlet in die Verfügbarkeitsgruppe einschließt. Verwenden Sie das Cmdlet New-SqlAvailabilityReplica, um ein AvailabilityReplica-Objekt abzurufen. Geben Sie den AsTemplate-Parameter an.

Parametereigenschaften

Typ:

AvailabilityReplica[]

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

Parametersätze

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

-BasicAvailabilityGroup

Das Cmdlet New-SqlAvailabilityGroup erstellt eine Verfügbarkeitsgruppe in AlwaysOn-Verfügbarkeitsgruppen. Der Parameter InputObject oder Path gibt den Server an, auf dem das ursprüngliche primäre Replikat gehostet wird.

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

-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

-Database

Gibt ein Array lokaler Benutzerdatenbanken mit Lese-/Schreibzugriff an. Diese Datenbanken müssen das vollständige Wiederherstellungsmodell verwenden und dürfen nicht AUTO_CLOSE verwenden. Diese Datenbanken können nicht zu einer anderen Verfügbarkeitsgruppe gehören und können nicht für die Datenbankspiegelung konfiguriert werden. Sie müssen einen Wert für diesen Parameter angeben.

Parametereigenschaften

Typ:

String[]

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

-DatabaseHealthTrigger

Das Cmdlet New-SqlAvailabilityGroup erstellt eine Verfügbarkeitsgruppe in AlwaysOn-Verfügbarkeitsgruppen. Der Parameter InputObject oder Path gibt den Server an, auf dem das ursprüngliche primäre Replikat gehostet wird.

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

-DtcSupportEnabled

Das Cmdlet New-SqlAvailabilityGroup erstellt eine Verfügbarkeitsgruppe in AlwaysOn-Verfügbarkeitsgruppen. Der Parameter InputObject oder Path gibt den Server an, auf dem das ursprüngliche primäre Replikat gehostet wird.

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

-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 niedrigeren Werts erfüllt ist, plus wenn ein interner kritischer Serverfehler auftritt, der aus dem Arbeitsspeicher besteht, schwerwiegende Schreibzugriffsverletzung oder zu viel Dumping.
  • OnModerateServerError. Failover oder Neustart, wenn eine Bedingung niedrigerer Werte erfüllt ist, plus wenn ein moderater Serverfehler auftritt, der eine persistente Zustand außerhalb des Arbeitsspeichers enthält.
  • 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 Dauer in Millisekunden an, nach der AlwaysOn-Verfügbarkeitsgruppen einen nicht reagierenden Server als fehlerhaft 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 Instanz von SQL Server an, die das primäre Replikat der Von diesem Cmdlet erstellten Verfügbarkeitsgruppe hosten soll.

Parametereigenschaften

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

Parametersätze

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

-Name

Gibt den Namen der Verfügbarkeitsgruppe an, die dieses Cmdlet erstellt.

Parametereigenschaften

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

Parametersätze

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

-Path

Gibt den Pfad der Instanz von SQL Server an, die das ursprüngliche primäre Replikat der Von diesem Cmdlet erstellten Verfügbarkeitsgruppe hosten soll. Wenn Sie diesen Parameter nicht angeben, verwendet dieses Cmdlet den aktuellen Arbeitsort. Wenn Sie einen Wert angeben, muss der Pfad zurzeit vorhanden sein.

Parametereigenschaften

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

Parametersätze

ByPath
Position:3
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.

Eingaben

Microsoft.SqlServer.Management.Smo.Server

Sie können eine Serverinstanz an dieses Cmdlet übergeben.

Ausgaben

Microsoft.SqlServer.Management.Smo.AvailabilityGroup

Dieses Cmdlet gibt eine Verfügbarkeitsgruppe zurück.