Compartir a través de

New-SqlAvailabilityGroup

Módulo:
SQLPS Module

Crea un grupo de disponibilidad.

Sintaxis

ByPath (Es el valor predeterminado). 

New-SqlAvailabilityGroup
    [-Name] <String>
    [[-Path] <String>]
    -AvailabilityReplica <AvailabilityReplica[]>
    [-Database <String[]>]
    [-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
    [-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
    [-HealthCheckTimeout <Int32>]
    [-BasicAvailabilityGroup]
    [-DatabaseHealthTrigger]
    [-DtcSupportEnabled]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByObject 

New-SqlAvailabilityGroup
    [-Name] <String>
    [-InputObject] <Server>
    -AvailabilityReplica <AvailabilityReplica[]>
    [-Database <String[]>]
    [-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
    [-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
    [-HealthCheckTimeout <Int32>]
    [-BasicAvailabilityGroup]
    [-DatabaseHealthTrigger]
    [-DtcSupportEnabled]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

El cmdlet New-SqlAvailabilityGroup crea un grupo de disponibilidad en grupos de disponibilidad AlwaysOn. El parámetro InputObject o Path especifica el servidor que hospeda la réplica principal inicial.

Ejemplos

Ejemplo 1: Creación de un grupo de disponibilidad

PS C:\> $PrimaryServer = Get-Item "SQLSERVER:\SQL\PrimaryServer\Instance22"
PS C:\> $SecondaryServer = Get-Item "SQLSERVER:\SQL\SecondaryServer\Instance22"
PS C:\> $PrimaryReplica = New-SqlAvailabilityReplica -Name "PrimaryServer\Instance22" -EndpointUrl "TCP://PrimaryServer.domain:5022" -FailoverMode "Automatic" -AvailabilityMode "SynchronousCommit" -AsTemplate -Version ($PrimaryServer.Version)
PS C:\> $SecondaryReplica = New-SqlAvailabilityReplica -Name "SecondaryServer\Instance22" -EndpointUrl "TCP://SecondaryServer.domain:5022" -FailoverMode "Automatic" -AvailabilityMode "SynchronousCommit" -AsTemplate -Version ($SecondaryServer.Version)
PS C:\> New-SqlAvailabilityGroup -InputObject $PrimaryServer -Name "MainAG" -AvailabilityReplica ($PrimaryReplica, $SecondaryReplica) -Database @("Database01","Database02")

El primer comando obtiene una instancia de SQL Server en el servidor principal y, a continuación, la almacena en la variable $PrimaryServer.

El segundo comando obtiene una instancia de SQL Server en el servidor secundario y, a continuación, la almacena en la variable $SecondaryServer.

El tercer comando crea una réplica que incluye la instancia del servidor principal mediante el cmdlet New-SqlAvailabilityReplica y, a continuación, la almacena en la variable $PrimaryReplica. El comando especifica la versión de la instancia del servidor mediante la propiedad Version de $PrimaryServer.

El cuarto comando crea una réplica que incluye la instancia del servidor secundario mediante New-SqlAvailabilityReplica y, a continuación, la almacena en la variable $SecondaryReplica. El comando especifica la versión de la instancia del servidor mediante la propiedad Version de $SecondaryServer.

El comando final crea el grupo de disponibilidad. Especifica el nombre, el servidor principal, las réplicas y otra información.

Parámetros

-AutomatedBackupPreference

Especifica la preferencia de copia de seguridad automatizada para el grupo de disponibilidad. Los valores aceptables para este parámetro son:

  • Primario. Especifica que las copias de seguridad siempre se producen en la réplica principal. Esta opción admite el uso de características que no están disponibles cuando la copia de seguridad se ejecuta en una réplica secundaria, como copias de seguridad diferenciales.
  • SecondaryOnly. Especifica que las copias de seguridad nunca se realizan en las réplicas principales. Si la réplica principal es la única réplica en línea, no se produce la copia de seguridad.
  • Secundario. Especifica que las copias de seguridad se producen en réplicas secundarias, a menos que la réplica principal sea la única réplica en línea. A continuación, la copia de seguridad se produce en la réplica principal.
  • Ninguno. Especifica que el estado principal o secundario no se tiene en cuenta al decidir qué réplica realiza copias de seguridad. En su lugar, la prioridad de copia de seguridad y el estado en línea determinan qué réplica realiza las copias de seguridad.

Propiedades del parámetro

Tipo:AvailabilityGroupAutomatedBackupPreference
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-AvailabilityReplica

Especifica una matriz de réplicas de disponibilidad que este cmdlet incluye en el grupo de disponibilidad. Para obtener un objeto AvailabilityReplica , use el cmdlet New-SqlAvailabilityReplica . Especifique el parámetro AsTemplate .

Propiedades del parámetro

Tipo:

AvailabilityReplica[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-BasicAvailabilityGroup

El cmdlet New-SqlAvailabilityGroup crea un grupo de disponibilidad en grupos de disponibilidad AlwaysOn. El parámetro InputObject o Path especifica el servidor que hospeda la réplica principal inicial.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Database

Especifica una matriz de bases de datos de usuario locales, de lectura y escritura. Estas bases de datos deben usar el modelo de recuperación completa y no deben usar AUTO_CLOSE. Estas bases de datos no pueden pertenecer a otro grupo de disponibilidad y no se pueden configurar para la creación de reflejo de la base de datos. Debe especificar un valor para este parámetro.

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DatabaseHealthTrigger

El cmdlet New-SqlAvailabilityGroup crea un grupo de disponibilidad en grupos de disponibilidad AlwaysOn. El parámetro InputObject o Path especifica el servidor que hospeda la réplica principal inicial.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DtcSupportEnabled

El cmdlet New-SqlAvailabilityGroup crea un grupo de disponibilidad en grupos de disponibilidad AlwaysOn. El parámetro InputObject o Path especifica el servidor que hospeda la réplica principal inicial.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-FailureConditionLevel

Especifica el comportamiento de conmutación automática por error del grupo de disponibilidad. Los valores aceptables para este parámetro son:

  • OnServerDown. Conmutación por error o reinicio si el servicio SQL Server se detiene.
  • OnServerUnresponsive. Conmutación por error o reinicio si se cumple alguna condición de valor inferior, además de cuando el servicio SQL Server está conectado al clúster y se supera el umbral HealthCheckTimeout , o si la réplica de disponibilidad actualmente en el rol principal está en estado de error.
  • OnCriticalServerError. Conmutación por error o reinicio si se cumple alguna condición de valor inferior, además de cuando se produce un error crítico interno del servidor, que incluye una condición de memoria insuficiente, una infracción grave de acceso de escritura o demasiado volcado.
  • OnModerateServerError. Conmutación por error o reinicio si se cumple alguna condición de valor inferior, además de si se produce un error moderado del servidor, lo que incluye una condición de memoria insuficiente persistente.
  • OnAnyQualifiedFailureConditions. Conmutación por error o reinicio si se cumple alguna condición de valor inferior, además de si se produce una condición de error apta, que incluye el agotamiento de subprocesos de trabajo del motor y el interbloqueo irrecuperable detectado.

Propiedades del parámetro

Tipo:AvailabilityGroupFailureConditionLevel
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-HealthCheckTimeout

Especifica el período de tiempo, en milisegundos, después del cual los grupos de disponibilidad AlwaysOn declaran un servidor que no responde para que sea incorrecto.

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-InputObject

Especifica la instancia de SQL Server que hospeda la réplica principal del grupo de disponibilidad que crea este cmdlet.

Propiedades del parámetro

Tipo:Server
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ByObject
Posición:3
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

Especifica el nombre del grupo de disponibilidad que crea este cmdlet.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:2
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Path

Especifica la ruta de acceso de la instancia de SQL Server que hospeda la réplica principal inicial del grupo de disponibilidad que crea este cmdlet. Si no especifica este parámetro, este cmdlet usa la ubicación de trabajo actual. Si especifica un valor, la ruta de acceso debe existir actualmente.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ByPath
Posición:3
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Script

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

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

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

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

Microsoft.SqlServer.Management.Smo.Server

Puede pasar una instancia de servidor a este cmdlet.

Salidas

Microsoft.SqlServer.Management.Smo.AvailabilityGroup

Este cmdlet devuelve un grupo de disponibilidad.