New-AzSqlDatabaseInstanceFailoverGroup

Referenz

Modul:: Az.Sql

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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FailoverPolicy

Die Failoverrichtlinie der Instanzfailovergruppe.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Location

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

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Der Name der zu erstellenden Azure SQL-Datenbank Failovergruppe.

Type:	String
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-PartnerManagedInstanceName

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

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-PartnerRegion

Der Name der Partnerregion der Instanzfailovergruppe.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-PartnerResourceGroupName

Der Name der sekundären Ressourcengruppe der Instanzfailovergruppe.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PartnerSubscriptionId

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PrimaryManagedInstanceName

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

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

Der Name der Ressourcengruppe.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Eingaben

String

Ausgaben

AzureSqlInstanceFailoverGroupModel