Compartir a través de

Switch-SqlAvailabilityGroup

  • Referencia
Módulo:
SQLPS

Inicia una conmutación por error de un grupo de disponibilidad en una réplica secundaria.

Sintaxis

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

Description

El cmdlet Switch-SqlAvailabilityGroup inicia una conmutación por error de un grupo de disponibilidad a una réplica secundaria especificada. Ejecute este cmdlet en la réplica secundaria de destino. Después de la conmutación por error, la réplica secundaria se convierte en la réplica principal.

Ejemplos

Ejemplo 1: Conmutación por error de un grupo de disponibilidad

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

Este comando realiza una conmutación por error manual del grupo de disponibilidad MainAG en la instancia de servidor denominada SecondaryServer\InstanceName. Este comando no permite la pérdida de datos. Ejecute este comando en la instancia del servidor que hospeda la réplica secundaria a la que se va a conmutar por error.

Ejemplo 2: Forzar una conmutación por error de un grupo de disponibilidad

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

Este comando realiza una conmutación por error manual del grupo de disponibilidad MainAG en la instancia de servidor denominada SecondaryServer\InstanceName. El comando especifica el parámetro AllowDataLoss . Por lo tanto, la conmutación por error tiene el potencial de pérdida de datos y el sistema le pide confirmación. Especifique el parámetro Force para omitir la confirmación.

Ejemplo 3: Creación de un script para conmutar por error un grupo de disponibilidad

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

Este comando crea un script de Transact-SQL que realiza una conmutación por error manual del grupo de disponibilidad MainAG a la instancia de servidor denominada SecondaryServer\InstanceName. El script no permite la pérdida de datos. El comando no provoca la conmutación por error.

Parámetros

-AllowDataLoss

Indica que este cmdlet inicia una conmutación por error forzada a la réplica secundaria de destino. Es posible que se pierdan datos. A menos que especifique el parámetro Force o Script , el cmdlet le pedirá confirmación.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Force

Obliga al comando a ejecutarse sin solicitar la confirmación del usuario. Este cmdlet le pide confirmación solo si especifica el parámetro AllowDataLoss .

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InputObject

Especifica el grupo de disponibilidad que este cmdlet conmuta por error.

Tipo:AvailabilityGroup[]
Posición:2
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Path

Especifica la ruta de acceso del grupo de disponibilidad que este cmdlet conmuta por error. Si no especifica este parámetro, este cmdlet usa la ubicación de trabajo actual.

Tipo:String[]
Posición:2
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Script

Indica que este cmdlet devuelve un script de Transact-SQL que realiza la tarea que realiza este cmdlet.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

Microsoft.SqlServer.Management.Smo.AvailabilityGroup

Puede pasar un grupo de disponibilidad a este cmdlet.