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.

Type:AllowReadOnlyFailoverToPrimary
Accepted values:Enabled, Disabled
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

-FailoverGroupName

Der Name der zu erstellenden Azure SQL-Datenbank Failovergruppe.

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

-FailoverPolicy

Die Failoverrichtlinie der Azure SQL-Datenbank Failovergruppe.

Type:FailoverPolicy
Accepted values:Automatic, Manual
Position:Named
Default value:Automatic
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:1
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PartnerResourceGroupName

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

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

-PartnerServerList

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

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PartnerServerName

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

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

-PartnerSubscriptionId

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

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

-ReadOnlyEndpointTargetServer

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

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

-ServerName

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

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

Eingaben

String

Ausgaben

AzureSqlFailoverGroupModel