New-AzSqlDatabaseFailoverGroup

  • Riferimento
Modulo:
Az.Sql

Questo comando crea un nuovo gruppo di failover database SQL di Azure.

Sintassi

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

Descrizione

Crea un nuovo gruppo di failover del database SQL di Azure per i server specificati. Due endpoint TDS database SQL di Azure vengono creati in FailoverGroupName.SqlDatabaseDnsSuffix (ad esempio, FailoverGroupName.database.windows.net) e FailoverGroupName.secondary.SqlDatabaseDnsSuffix. Questi endpoint possono essere usati per connettersi rispettivamente ai server primari e secondari nel gruppo di failover. Se il server primario è interessato da un'interruzione, il failover automatico degli endpoint e dei database verrà attivato in base ai criteri di failover del gruppo di failover e al periodo di tolleranza. I gruppi di failover appena creati non contengono database. Per controllare il set di database in un gruppo di failover, usare i cmdlet 'Add-AzSqlDatabaseToFailoverGroup' e 'Remove-AzSqlDatabaseFromFailoverGroup'. Per il parametro '-GracePeriodWithDataLossHours' sono supportati solo valori maggiori o uguali a 1 ora.

[! NOTA] È possibile distribuire il gruppo di failover automatico tra sottoscrizioni usando il parametro -PartnerSubscriptionId in Azure PowerShell a partire da Az.SQL 3.11.0.

Esempio

Esempio 1

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

Questo comando crea un nuovo gruppo di failover con criteri di failover "Automatico" per due server nello stesso gruppo di risorse.

Esempio 2

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

Questo comando crea un nuovo gruppo di failover con criteri di failover "Manuale" per due server in gruppi di risorse diversi.

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

Questo comando crea un nuovo gruppo di failover con criteri di failover "Manuale" per due server in sottoscrizioni diverse.

Parametri

-AllowReadOnlyFailoverToPrimary

Indica se un'interruzione nel server secondario deve attivare il failover automatico dell'endpoint di sola lettura.

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

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure

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

-FailoverGroupName

Nome del gruppo di failover database SQL di Azure da creare.

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

-FailoverPolicy

Criteri di failover del gruppo di failover database SQL di Azure.

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

-GracePeriodWithDataLossHours

Intervallo prima dell'avvio del failover automatico se si verifica un'interruzione nel server primario e il failover non può essere completato senza perdita di dati.

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

-PartnerResourceGroupName

Nome del gruppo di risorse secondario del gruppo di risorse database SQL di Azure gruppo di failover.

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

-PartnerServerList

Elenco di server partner nel gruppo di failover (elenco vuoto per 0 server).

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

-PartnerServerName

Nome del server secondario del gruppo di failover database SQL di Azure.

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

-PartnerSubscriptionId

Nome dell'ID sottoscrizione secondaria del gruppo di failover database SQL di Azure.

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

-ReadOnlyEndpointTargetServer

Nome del server di destinazione per l'endpoint di sola lettura. Se vuoto, il valore predefinito è PartnerServerName.

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

-ResourceGroupName

Nome del gruppo di risorse.

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

-ServerName

Nome del server primario database SQL di Azure del gruppo di failover.

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

Input

String

Output

AzureSqlFailoverGroupModel