Freigeben über


New-AzSqlDatabaseFailoverGroup

Mit diesem Befehl wird eine neue Azure SQL-Datenbankfailovergruppe erstellt.

Syntax

Default (Standard)

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-Datenbankfailovergruppe 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 bereitzustellen, indem Sie den Parameter -PartnerSubscriptionId in Azure Powershell ab Az.SQL 3.11.0 verwenden.

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.

Parametereigenschaften

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

-DefaultProfile

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

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

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

-FailoverGroupName

Der Name der zu erstellenden Azure SQL-Datenbankfailovergruppe.

Parametereigenschaften

Typ:String
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

-FailoverPolicy

Die Failoverrichtlinie der Azure SQL-Datenbankfailovergruppe.

Parametereigenschaften

Typ:FailoverPolicy
Standardwert:Manual
Zulässige Werte:Automatic, Manual
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

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

Parametereigenschaften

Typ:Int32
Standardwert:1
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

-PartnerResourceGroupName

Der Name der sekundären Ressourcengruppe der Azure SQL-Datenbankfailovergruppe.

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

-PartnerServerList

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

Parametereigenschaften

Typ:

List<T>[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

-PartnerServerName

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

Parametereigenschaften

Typ:String
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

-PartnerSubscriptionId

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

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

-ReadOnlyEndpointTargetServer

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

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

-ResourceGroupName

Der Name der Ressourcengruppe.

Parametereigenschaften

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

Parametersätze

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

-ServerName

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

Parametereigenschaften

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

Parametersätze

(All)
Position:1
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
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

String

Ausgaben

AzureSqlFailoverGroupModel