Freigeben über


New-AzSqlDatabaseInstanceFailoverGroup

Mit diesem Befehl wird eine neue Failovergruppe für Azure SQL-Datenbankinstanzen 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-Datenbankinstanzfailovergruppe zwischen den angegebenen Regionen mit dem angegebenen Verwalteten Instanzpaar.

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 Paar verwalteter Instanzen 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 Paar verwalteter Instanzen erstellt.

Beispiel 3

Mit diesem Befehl wird eine neue Failovergruppe für Azure SQL-Datenbankinstanzen 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

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

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

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

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

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

-PartnerManagedInstanceName

Der Name der verwalteten 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 verwalteten 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 verwalteten 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 passiert, 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

Ausgaben