New-AzSqlDatabaseFailoverGroup

  • Odwołanie
Moduł:
Az.Sql

To polecenie tworzy nową grupę trybu failover usługi Azure SQL Database.

Składnia

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

Opis

Tworzy nową grupę trybu failover usługi Azure SQL Database dla wybranych serwerów. Dwa punkty końcowe TDS usługi Azure SQL Database są tworzone w folderze FailoverGroupName.SqlDatabaseDnsSuffix (na przykład FailoverGroupName.database.windows.net) i FailoverGroupName.secondary.SqlDatabaseDnsSuffix. Te punkty końcowe mogą służyć do łączenia się odpowiednio z serwerami podstawowymi i pomocniczymi w grupie trybu failover. Jeśli na serwer podstawowy wystąpi awaria, automatyczne przejście w tryb failover punktów końcowych i baz danych zostanie wyzwolone zgodnie z zasadami trybu failover grupy trybu failover i okresem prolongaty. Nowo utworzone grupy trybu failover nie zawierają żadnych baz danych. Aby kontrolować zestaw baz danych w grupie trybu failover, użyj poleceń cmdlet "Add-AzSqlDatabaseToFailoverGroup" i "Remove-AzSqlDatabaseFromFailoverGroup". Dla parametru "-GracePeriodWithDataLossHours" obsługiwane są tylko wartości większe niż lub równe 1 godzinę.

[! UWAGA] Istnieje możliwość wdrożenia grupy automatycznego trybu failover w ramach subskrypcji przy użyciu parametru -PartnerSubscriptionId w programie Azure PowerShell, począwszy od Az.SQL 3.11.0.

Przykłady

Przykład 1

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

To polecenie tworzy nową grupę trybu failover z zasadami trybu failover "Automatyczny" dla dwóch serwerów w tej samej grupie zasobów.

Przykład 2

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

To polecenie tworzy nową grupę trybu failover z zasadami trybu failover "Manual" dla dwóch serwerów w różnych grupach zasobów.

Przykład 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                        : {}

To polecenie tworzy nową grupę trybu failover z zasadami trybu failover "Manual" dla dwóch serwerów w różnych subskrypcjach.

Parametry

-AllowReadOnlyFailoverToPrimary

Czy awaria na serwerze pomocniczym powinna wyzwalać automatyczne przejście w tryb failover punktu końcowego tylko do odczytu.

Type:AllowReadOnlyFailoverToPrimary
Accepted values:Enabled, Disabled
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure

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

-FailoverGroupName

Nazwa grupy trybu failover usługi Azure SQL Database do utworzenia.

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

-FailoverPolicy

Zasady trybu failover grupy trybu failover usługi Azure SQL Database.

Type:FailoverPolicy
Accepted values:Automatic, Manual
Position:Named
Default value:Automatic
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GracePeriodWithDataLossHours

Interwał przed zainicjowaniem automatycznego przejścia w tryb failover, jeśli wystąpi awaria na serwerze podstawowym i nie można ukończyć pracy w trybie failover bez utraty danych.

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

-PartnerResourceGroupName

Nazwa pomocniczej grupy zasobów grupy trybu failover usługi Azure SQL Database.

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

-PartnerServerList

Lista serwerów partnerskich w grupie trybu failover (pusta lista dla 0 serwerów).

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

-PartnerServerName

Nazwa serwera pomocniczego grupy trybu failover usługi Azure SQL Database.

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

-PartnerSubscriptionId

Nazwa pomocniczej identyfikatora subskrypcji grupy trybu failover usługi Azure SQL Database.

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

-ReadOnlyEndpointTargetServer

Nazwa serwera docelowego dla punktu końcowego tylko do odczytu. Jeśli wartość jest pusta, wartość domyślna to PartnerServerName.

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

-ResourceGroupName

Nazwa grupy zasobów.

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

-ServerName

Nazwa podstawowego serwera usługi Azure SQL Database grupy trybu failover.

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

Dane wejściowe

String

Dane wyjściowe

AzureSqlFailoverGroupModel