Compartilhar via


Set-AzSqlDatabaseInstanceFailoverGroup

Modifica a configuração de um Grupo de Failover de Instância.

Sintaxe

SetInstanceFailoverGroupDefaultSet (Default)

Set-AzSqlDatabaseInstanceFailoverGroup
    [-ResourceGroupName] <String>
    [-Location] <String>
    [-Name] <String>
    [-FailoverPolicy <String>]
    [-GracePeriodWithDataLossHours <Int32>]
    [-AllowReadOnlyFailoverToPrimary <String>]
    [-SecondaryType <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetInstanceFailoverGroupByResourceIdSet

Set-AzSqlDatabaseInstanceFailoverGroup
    [-Location] <String>
    [-ResourceId] <String>
    [-FailoverPolicy <String>]
    [-GracePeriodWithDataLossHours <Int32>]
    [-AllowReadOnlyFailoverToPrimary <String>]
    [-SecondaryType <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetInstanceFailoverGroupByAzureSqlInstanceFailoverGroupModelSet

Set-AzSqlDatabaseInstanceFailoverGroup
    [-InputObject] <AzureSqlInstanceFailoverGroupModel>
    [-FailoverPolicy <String>]
    [-GracePeriodWithDataLossHours <Int32>]
    [-AllowReadOnlyFailoverToPrimary <String>]
    [-SecondaryType <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Esse comando modifica a configuração de um Grupo de Failover de Instância.

A região primária do Grupo de Failover de Instância deve ser usada para executar o comando.

Durante a visualização do recurso Grupos de Failover de Instância, há suporte apenas para valores maiores ou iguais a 1 hora para o parâmetro '-GracePeriodWithDataLossHours'.

Exemplos

Exemplo 1

$failoverGroup = Get-AzSqlDatabaseInstanceFailoverGroup -ResourceGroupName rg -Location location -Name fg | Set-AzSqlDatabaseInstanceFailoverGroup -FailoverPolicy Manual
ResourceGroupName                     : rg
Location                              : East US
Name                                  : fg
PartnerResourceGroupName              : rg
PartnerRegion                         : West US
PrimaryManagedInstanceName            : managedInstance1
PartnerManagedInstanceName            : managedInstance2
ReplicationRole                       : Primary
ReplicationState                      : CATCH_UP
ReadWriteFailoverPolicy               : Manual
FailoverWithDataLossGracePeriodHours  :
ReadOnlyFailoverPolicy                : Disabled
Id                                    : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/rg/providers/Microsoft.Sql/locations/eastus/instanceFailoverGroups/fg

Define a política de failover de um grupo de failover de instância como 'Manual' canalizando no Grupo de Failover.

Parâmetros

-AllowReadOnlyFailoverToPrimary

Se as interrupções no servidor secundário devem disparar o failover automático do ponto de extremidade somente leitura.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.

Propriedades do parâmetro

Tipo:IAzureContextContainer
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-FailoverPolicy

A política de failover do Grupo de Failover de Instância.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-GracePeriodWithDataLossHours

Intervalo antes do failover automático ser iniciado se ocorrer uma interrupção no servidor primário e o failover não puder ser concluído sem perda de dados.

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-InputObject

O objeto Grupo de Failover de Instância a ser definido

Propriedades do parâmetro

Tipo:AzureSqlInstanceFailoverGroupModel
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

SetInstanceFailoverGroupByAzureSqlInstanceFailoverGroupModelSet
Cargo:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Location

O nome da Região Local da qual recuperar o Grupo de Failover de Instância.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

SetInstanceFailoverGroupDefaultSet
Cargo:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
SetInstanceFailoverGroupByResourceIdSet
Cargo:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Name

O nome do Grupo de Failover de Instância.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

SetInstanceFailoverGroupDefaultSet
Cargo:2
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ResourceGroupName

O nome do grupo de recursos.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

SetInstanceFailoverGroupDefaultSet
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ResourceId

A ID do recurso do grupo de failover de instância a ser definido.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

SetInstanceFailoverGroupByResourceIdSet
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-SecondaryType

Uso pretendido da instância secundária. Espera indica que a instância secundária será usada apenas como uma réplica passiva para recuperação de desastre.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

AzureSqlInstanceFailoverGroupModel

System.String

Saídas

AzureSqlInstanceFailoverGroupModel