Freigeben über


New-AzSqlDatabaseInstanceFailoverGroup

Mit diesem Befehl wird eine neue Azure SQL-Datenbank Instanzfailovergruppe erstellt.

Syntax

New-AzSqlDatabaseInstanceFailoverGroup
   [-Name] <String>
   [-PartnerResourceGroupName <String>]
   -PartnerRegion <String>
   -PrimaryManagedInstanceName <String>
   -PartnerManagedInstanceName <String>
   [-PartnerSubscriptionId <String>]
   [-FailoverPolicy <String>]
   [-GracePeriodWithDataLossHours <Int32>]
   [-AllowReadOnlyFailoverToPrimary <String>]
   [-SecondaryType <String>]
   [-ResourceGroupName] <String>
   [-Location] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Erstellt eine neue Azure SQL-Datenbank Instanzfailovergruppe zwischen den angegebenen Regionen mit dem angegebenen verwaltete Instanz-Paar.

Zwei Azure SQL-Datenbank TDS-Endpunkte werden unter Name.SqlDatabaseDnsSuffix (z. B. Name.database.windows.net) und Name.secondary.SqlDatabaseDnsSuffix erstellt. Diese Endpunkte können verwendet werden, um eine Verbindung mit den primären und sekundären Regionen der Failovergruppe herzustellen. Wenn die primäre Region von einem Ausfall betroffen ist, wird das automatische Failover der Endpunkte und Datenbanken wie durch die Failoverrichtlinie und den Karenzzeitraum der Instanzfailovergruppe ausgelöst.

Während der Vorschau auf das Feature "Instanzfailovergruppen" werden nur Werte unterstützt, die größer oder gleich 1 Stunde für den Parameter "-GracePeriodWithDataLossHours" sind.

Beispiele

Beispiel 1

$failoverGroup = New-AzSqlDatabaseInstanceFailoverGroup -Name fgName -Location location -ResourceGroupName rg -PrimaryManagedInstanceName $managedInstance.Name -PartnerRegion $partnerRegion -PartnerManagedInstanceName $partnerManagedInstance.Name -FailoverPolicy Automatic -GracePeriodWithDataLossHours 1

ResourceGroupName                     : rg
Location                              : East US
Name                                  : fg
PartnerResourceGroupName              : rg
PartnerRegion                         : West US
PrimaryManagedInstanceName            : managedInstance1
PartnerManagedInstanceName            : managedInstance2
ReplicationRole                       : Primary
ReplicationState                      : CATCH_UP
ReadWriteFailoverPolicy               : Automatic
FailoverWithDataLossGracePeriodHours  : 1
ReadOnlyFailoverPolicy                : Disabled
Id                                    : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/rg/providers/Microsoft.Sql/locations/eastus/instanceFailoverGroups/fg

Mit diesem Befehl wird eine neue Instanzfailovergruppe mit der Failoverrichtlinie "Automatisch" für das verwaltete Instanz-Paar erstellt.

Beispiel 2

$failoverGroup = New-AzSqlDatabaseInstanceFailoverGroup -Name fgName -Location location -ResourceGroupName rg -PrimaryManagedInstanceName $managedInstance.Name -PartnerRegion $partnerRegion -PartnerManagedInstanceName $partnerManagedInstance.Name -FailoverPolicy Manual

ResourceGroupName                     : rg
Location                              : East US
Name                                  : fg
PartnerResourceGroupName              : rg
PartnerRegion                         : West US
PrimaryManagedInstanceName            : managedInstance1
PartnerManagedInstanceName            : managedInstance2
ReplicationRole                       : Primary
ReplicationState                      : CATCH_UP
ReadWriteFailoverPolicy               : Manual
FailoverWithDataLossGracePeriodHours  :
ReadOnlyFailoverPolicy                : Disabled
Id                                    : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/rg/providers/Microsoft.Sql/locations/eastus/instanceFailoverGroups/fg

Mit diesem Befehl wird eine neue Instanzfailovergruppe mit Failoverrichtlinie "Manuell" für das verwaltete Instanz-Paar erstellt.

Beispiel 3

Mit diesem Befehl wird eine neue Azure SQL-Datenbank Instanzfailovergruppe erstellt. (automatisch generiert)

New-AzSqlDatabaseInstanceFailoverGroup -FailoverPolicy Automatic -GracePeriodWithDataLossHours 1 -Location location -Name fgName -PartnerManagedInstanceName $partnerManagedInstance.Name -PartnerRegion $partnerRegion -PartnerResourceGroupName rg2 -PrimaryManagedInstanceName $managedInstance.Name -ResourceGroupName rg

Parameter

-AllowReadOnlyFailoverToPrimary

Gibt an, ob ein Ausfall auf dem sekundären Server das automatische Failover des schreibgeschützten Endpunkts auslösen soll.

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

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-FailoverPolicy

Die Failoverrichtlinie der Instanzfailovergruppe.

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

-GracePeriodWithDataLossHours

Intervall vor dem Initiieren eines automatischen Failovers, wenn ein Ausfall auf dem primären Server auftritt und Failover ohne Datenverlust nicht abgeschlossen werden kann.

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

-Location

Der Name der lokalen Region, aus der die Instanzfailovergruppe abgerufen werden soll.

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

-Name

Der Name der zu erstellenden Azure SQL-Datenbank Failovergruppe.

Typ:String
Position:2
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PartnerManagedInstanceName

Der Name der verwaltete Instanz in der Partnerregion, die der Instanzfailovergruppe hinzugefügt werden soll.

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

-PartnerRegion

Der Name der Partnerregion der Instanzfailovergruppe.

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

-PartnerResourceGroupName

Der Name der sekundären Ressourcengruppe der Instanzfailovergruppe.

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

-PartnerSubscriptionId

Die Abonnement-ID der sekundären verwaltete Instanz der Instanzfailovergruppe. Dieser Parameter ist nur für die Abonnementübergreifende Einrichtung erforderlich.

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

-PrimaryManagedInstanceName

Der Name der verwaltete Instanz in der lokalen Region, die der Instanzfailovergruppe hinzugefügt werden soll.

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

-ResourceGroupName

Der Name der Ressourcengruppe.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SecondaryType

Beabsichtigte Verwendung der sekundären Instanz. Standby gibt an, dass die sekundäre Instanz nur als passives Replikat für die Notfallwiederherstellung verwendet wird.

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

-WhatIf

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

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

Eingaben

String

Ausgaben

AzureSqlInstanceFailoverGroupModel