Delen via

New-AzSqlDatabaseFailoverGroup

  • Referentie
Module:
Az.Sql

Met deze opdracht maakt u een nieuwe Azure SQL Database-failovergroep.

Syntaxis

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

Description

Hiermee maakt u een nieuwe Azure SQL Database-failovergroep voor de gespecificeerde servers. Er worden twee Azure SQL Database TDS-eindpunten gemaakt op FailoverGroupName.SqlDatabaseDnsSuffix (bijvoorbeeld FailoverGroupName.database.windows.net) en FailoverGroupName.secondary.SqlDatabaseDnsSuffix. Deze eindpunten kunnen worden gebruikt om respectievelijk verbinding te maken met de primaire en secundaire servers in de failovergroep. Als de primaire server wordt beïnvloed door een storing, wordt automatische failover van de eindpunten en databases geactiveerd volgens het failoverbeleid en de respijtperiode van de failovergroep. Nieuwe failovergroepen bevatten geen databases. Als u de set databases in een failovergroep wilt beheren, gebruikt u de cmdlets Add-AzSqlDatabaseToFailoverGroup en Remove-AzSqlDatabaseFromFailoverGroup. Alleen waarden groter dan of gelijk aan 1 uur worden ondersteund voor de parameter '-GracePeriodWithDataLossHours'.

[! OPMERKING] Het is mogelijk om uw groep voor automatische failover tussen abonnementen te implementeren met behulp van de parameter -PartnerSubscriptionId in Azure Powershell vanaf Az.SQL 3.11.0.

Voorbeelden

Voorbeeld 1

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

Met deze opdracht maakt u een nieuwe failovergroep met failoverbeleid 'Automatisch' voor twee servers in dezelfde resourcegroep.

Voorbeeld 2

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

Met deze opdracht maakt u een nieuwe failovergroep met failoverbeleid 'Handmatig' voor twee servers in verschillende resourcegroepen.

Voorbeeld 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                        : {}

Met deze opdracht maakt u een nieuwe failovergroep met failoverbeleid 'Handmatig' voor twee servers in verschillende abonnementen.

Parameters

-AllowReadOnlyFailoverToPrimary

Of een storing op de secundaire server automatische failover van het alleen-lezeneindpunt moet activeren.

Type:AllowReadOnlyFailoverToPrimary
Geaccepteerde waarden:Enabled, Disabled
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-FailoverGroupName

De naam van de Azure SQL Database-failovergroep die moet worden gemaakt.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-FailoverPolicy

Het failoverbeleid van de Azure SQL Database-failovergroep.

Type:FailoverPolicy
Geaccepteerde waarden:Automatic, Manual
Position:Named
Default value:Manual
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-GracePeriodWithDataLossHours

Interval voordat automatische failover wordt gestart als er een storing op de primaire server optreedt en failover niet kan worden voltooid zonder gegevensverlies.

Type:Int32
Position:Named
Default value:1
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PartnerResourceGroupName

De naam van de secundaire resourcegroep van de Azure SQL Database-failovergroep.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PartnerServerList

De lijst met partnerservers in de failovergroep (lege lijst voor 0 servers).

Type:List<T>[String]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PartnerServerName

De naam van de secundaire server van de Azure SQL Database-failovergroep.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PartnerSubscriptionId

De naam van de secundaire abonnements-id van de Azure SQL Database-failovergroep.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ReadOnlyEndpointTargetServer

De naam van de doelserver voor het alleen-lezeneindpunt. Als dit leeg is, wordt standaard de waarde van PartnerServerName gebruikt.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ResourceGroupName

De naam van de resourcegroep.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ServerName

De naam van de primaire Azure SQL Database Server van de failovergroep.

Type:String
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Invoerwaarden

String

Uitvoerwaarden

AzureSqlFailoverGroupModel