Compartilhar via

Switch-SqlAvailabilityGroup

  • Referência
Módulo:
SQLPS

Inicia um failover de um grupo de disponibilidade para um réplica secundário.

Sintaxe

Switch-SqlAvailabilityGroup
      [-AllowDataLoss]
      [-Force]
      [[-Path] <String[]>]
      [-Script]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Switch-SqlAvailabilityGroup
      [-AllowDataLoss]
      [-Force]
      [-InputObject] <AvailabilityGroup[]>
      [-Script]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O cmdlet Switch-SqlAvailabilityGroup inicia um failover de um grupo de disponibilidade para um réplica secundário especificado. Execute este cmdlet no réplica secundário de destino. Após o failover, o réplica secundário se torna o réplica primário.

Exemplos

Exemplo 1: fazer failover de um grupo de disponibilidade

PS C:\> Switch-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\SecondaryServer\InstanceName\AvailabilityGroups\MainAG"

Esse comando executa um failover manual do grupo de disponibilidade MainAG para a instância de servidor chamada SecondaryServer\InstanceName. Esse comando não permite a perda de dados. Execute esse comando na instância do servidor que hospeda a réplica secundária à qual fazer failover.

Exemplo 2: Forçar um grupo de disponibilidade a fazer failover

PS C:\> Switch-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\SecondaryServer\InstanceName\AvailabilityGroups\MainAG" -AllowDataLoss

Esse comando executa um failover manual do grupo de disponibilidade MainAG para a instância de servidor chamada SecondaryServer\InstanceName. O comando especifica o parâmetro AllowDataLoss . Portanto, o failover tem o potencial de perda de dados e o comando solicita confirmação. Especifique o parâmetro Force para ignorar a confirmação.

Exemplo 3: criar um script para fazer failover de um grupo de disponibilidade

PS C:\>Switch-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\SecondaryServer\InstanceName\AvailabilityGroups\MainAG" -Script

Esse comando cria um script Transact-SQL que executa um failover manual do grupo de disponibilidade MainAG para a instância de servidor chamada SecondaryServer\InstanceName. O script não permite a perda de dados. O comando não causa failover.

Parâmetros

-AllowDataLoss

Indica que esse cmdlet inicia um failover forçado para o réplica secundário de destino. É possível haver perda de dados. A menos que você especifique o parâmetro Force ou Script , o cmdlet solicitará confirmação.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Force

Força o comando a ser executado sem solicitar a confirmação do usuário. Esse cmdlet solicitará confirmação somente se você especificar o parâmetro AllowDataLoss .

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Especifica o grupo de disponibilidade que esse cmdlet faz failover.

Tipo:AvailabilityGroup[]
Cargo:2
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Path

Especifica o caminho do grupo de disponibilidade que esse cmdlet faz failover. Se você não especificar esse parâmetro, esse cmdlet usará o local de trabalho atual.

Tipo:String[]
Cargo:2
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Script

Indica que esse cmdlet retorna um script Transact-SQL que executa a tarefa que esse cmdlet executa.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.SqlServer.Management.Smo.AvailabilityGroup

Você pode passar um grupo de disponibilidade para esse cmdlet.