New-AzSqlDatabaseFailoverGroup

  • Referenz
Modul:
Az.Sql

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

Syntax

New-AzSqlDatabaseFailoverGroup
   [-ServerName] <String>
   -FailoverGroupName <String>
   [-PartnerSubscriptionId <String>]
   [-PartnerResourceGroupName <String>]
   -PartnerServerName <String>
   [-FailoverPolicy <FailoverPolicy>]
   [-GracePeriodWithDataLossHours <Int32>]
   [-AllowReadOnlyFailoverToPrimary <AllowReadOnlyFailoverToPrimary>]
   [-PartnerServerList <System.Collections.Generic.List`1[System.String]>]
   [-ReadOnlyEndpointTargetServer <String>]
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Beschreibung

Erstellt eine neue Azure SQL-Datenbank-Failovergruppe für die angegebenen Server. Bei FailoverGroupName.SqlDatabaseDnsSuffix (z. B. FailoverGroupName.database.windows.net) und FailoverGroupName.secondary.SqlDatabaseDnsSuffix werden zwei Azure SQL-Datenbank TDS-Endpunkte erstellt. Diese Endpunkte können verwendet werden, um eine Verbindung mit den primären und sekundären Servern in der Failovergruppe herzustellen. Wenn der primäre Server von einem Ausfall betroffen ist, wird das automatische Failover der Endpunkte und Datenbanken gemäß der Failoverrichtlinie und der Karenzzeit der Failovergruppe ausgelöst. Neu erstellte Failovergruppen enthalten keine Datenbanken. Verwenden Sie zum Steuern der Datenbankgruppe in einer Failovergruppe die Cmdlets "Add-AzSqlDatabaseToFailoverGroup" und "Remove-AzSqlDatabaseFromFailoverGroup". Für den Parameter "-GracePeriodWithDataLossHours" werden nur Werte unterstützt, die größer oder gleich 1 Stunde sind.

[! HINWEIS] Es ist möglich, Ihre automatische Failovergruppe über Abonnements hinweg mithilfe des Parameters "-PartnerSubscriptionId" in Azure Powershell bereitzustellen, beginnend mit Az.SQL 3.11.0.

Beispiele

Beispiel 1

$failoverGroup = New-AzSqlDatabaseFailoverGroup -ResourceGroupName rg -ServerName primaryserver -PartnerServerName secondaryserver -FailoverGroupName fg -FailoverPolicy Automatic -GracePeriodWithDataLossHours 1

Dieser Befehl erstellt eine neue Failovergruppe mit Failoverrichtlinie "Automatisch" für zwei Server in derselben Ressourcengruppe.

Beispiel 2

$failoverGroup = New-AzSqlDatabaseFailoverGroup -ResourceGroupName rg1 -ServerName primaryserver -PartnerResourceGroupName rg2 -PartnerServerName secondaryserver1 -FailoverGroupName fg -FailoverPolicy Manual

Dieser Befehl erstellt eine neue Failovergruppe mit Failoverrichtlinie "Manuell" für zwei Server in verschiedenen Ressourcengruppen.

Beispiel 3

$sub2 = 'b3c40cd6-024f-428c-921b-cda6c6834c34'
$failoverGroup = New-AzSqlDatabaseFailoverGroup -ServerName primaryserver -FailoverGroupName fg -PartnerSubscriptionId $sub2 -PartnerResourceGroupName rg2 -PartnerServerName secondaryserver1 -FailoverPolicy Manual -ResourceGroupName rg1

FailoverGroupName                    : fg
Location                             : East US
ResourceGroupName                    : rg1
ServerName                           : primaryserver
PartnerLocation                      : West US 2
PartnerResourceGroupName             : rg2
PartnerServerName                    : secondaryserver1
ReplicationRole                      : Primary
ReplicationState                     : CATCH_UP
ReadWriteFailoverPolicy              : Manual
FailoverWithDataLossGracePeriodHours :
DatabaseNames                        : {}

Mit diesem Befehl wird eine neue Failovergruppe mit Failoverrichtlinie "Manuell" für zwei Server in unterschiedlichen Abonnements erstellt.

Parameter

-AllowReadOnlyFailoverToPrimary

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

Typ:AllowReadOnlyFailoverToPrimary
Zulässige Werte:Enabled, Disabled
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

-FailoverGroupName

Der Name der zu erstellenden Azure SQL-Datenbank Failovergruppe.

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

-FailoverPolicy

Die Failoverrichtlinie der Azure SQL-Datenbank Failovergruppe.

Typ:FailoverPolicy
Zulässige Werte:Automatic, Manual
Position:Named
Standardwert:Manual
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:1
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PartnerResourceGroupName

Der Name der sekundären Ressourcengruppe der Azure SQL-Datenbank Failovergruppe.

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

-PartnerServerList

Die Liste der Partnerserver in der Failovergruppe (leere Liste für 0 Server).

Typ:List<T>[String]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PartnerServerName

Der Name des sekundären Servers der Azure SQL-Datenbank Failovergruppe.

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

-PartnerSubscriptionId

Der Name der sekundären Abonnement-ID der Azure SQL-Datenbank Failovergruppe.

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

-ReadOnlyEndpointTargetServer

Der Name des Zielservers für den schreibgeschützten Endpunkt. Wenn leer, wird standardmäßig der Wert "PartnerServerName" verwendet.

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

-ResourceGroupName

Der Name der Ressourcengruppe.

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

-ServerName

Der Name des primären Azure SQL-Datenbank Servers der Failovergruppe.

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

Eingaben

String

Ausgaben

AzureSqlFailoverGroupModel