Join-SqlAvailabilityGroup

Módulo:

SQLServer

Une la réplica secundaria local a un grupo de disponibilidad.

Syntax

Join-SqlAvailabilityGroup
    [-Name] <String>
    [[-Path] <String>]
    [-ClusterType <AvailabilityGroupClusterType>]
    [-Script]
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Join-SqlAvailabilityGroup
    [-Name] <String>
    [-InputObject] <Server>
    [-ClusterType <AvailabilityGroupClusterType>]
    [-Script]
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

El cmdlet Join-SqlAvailabilityGroup une la réplica secundaria local a un grupo de disponibilidad.

Ejecute este cmdlet en una instancia de SQL Server que hospeda una réplica secundaria que no está unida al grupo de disponibilidad.

Ejemplos

Ejemplo 1: Unión de una réplica secundaria a un grupo de disponibilidad

PS C:\> Join-SqlAvailabilityGroup -Path "SQLSERVER:\SQL\SecondaryServer\InstanceName" -Name "MainAG"

Este comando une una réplica secundaria al grupo de disponibilidad denominado "MainAG". Esta instancia de servidor debe hospedar una replicación secundaria en este grupo de disponibilidad.

Ejemplo 2: Creación de un script que une una réplica secundaria a un grupo de disponibilidad

PS C:\> Join-SqlAvailabilityGroup -Path "SQLSERVER:\SQL\SecondaryServer\InstanceName" -Name "MainAG" -Script

Este comando crea un script de Transact-SQL que une una réplica secundaria al grupo de disponibilidad denominado "MainAG".

Parámetros

-AccessToken

Token de acceso que se usa para autenticarse en SQL Server, como alternativa a la autenticación de usuario o contraseña de Windows.

Esto se puede usar, por ejemplo, para conectarse a SQL Azure DB y SQL Azure Managed Instance usar o Service Principal .Managed Identity

El parámetro que se va a usar puede ser una cadena que representa el token o un PSAccessToken objeto tal como se devuelve mediante la ejecución Get-AzAccessToken -ResourceUrl https://database.windows.netde .

Este parámetro es nuevo en la versión 22 del módulo.

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

-ClusterType

Tipo de clúster que respalda el grupo de disponibilidad. Los valores posibles son:

• Wsfc. El grupo de disponibilidad se integrará en el clúster de conmutación por error de Windows Server. Así es como se crean los grupos de disponibilidad en SQL Server 2016 y versiones posteriores. Este es el valor predeterminado.
• Ninguno. El grupo de disponibilidad será independiente del clúster.
• Externos. El grupo de disponibilidad se administrará mediante un administrador de clústeres que no sea un clúster de conmutación por error de Windows Server, como Pacemaker en Linux. Esto se admite en SQL Server 2017 y versiones posteriores. Cuando el destino SQL Server en Linux, debe especificar este valor o un error occour.

Type:	AvailabilityGroupClusterType
Accepted values:	Wsfc, None, External
Position:	Named
Default value:	Wsfc
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Encrypt

Tipo de cifrado que se va a usar al conectarse a SQL Server.

Este valor se asigna a la Encrypt propiedad SqlConnectionEncryptOption del objeto SqlConnection del controlador Microsoft.Data.SqlClient.

En la versión 22 del módulo, el valor predeterminado es Optional (por compatibilidad con v21). En la versión 23+ del módulo, el valor predeterminado será "Obligatorio", lo que puede crear un cambio importante para los scripts existentes.

Este parámetro es nuevo en la versión 22 del módulo.

Type:	String
Accepted values:	Mandatory, Optional, Strict
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HostNameInCertificate

Nombre de host que se va a usar al validar el certificado TLS/SSL de SQL Server. Debe pasar este parámetro si la instancia de SQL Server está habilitada para Forzar cifrado y desea conectarse a una instancia mediante el nombre de host o el nombre corto. Si se omite este parámetro, es necesario pasar el nombre de dominio completo (FQDN) a -ServerInstance para conectarse a una instancia de SQL Server habilitada para forzar el cifrado.

Este parámetro es nuevo en la versión 22 del módulo.

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

-InputObject

Especifica el servidor que hospeda la instancia de SQL Server que hospeda la réplica secundaria que este cmdlet une al grupo de disponibilidad.

Type:	Server
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Especifica el nombre del grupo de disponibilidad al que este cmdlet se une a una réplica secundaria.

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

-Path

Especifica la ruta de acceso de la instancia de SQL Server que hospeda la réplica secundaria que este cmdlet une al grupo de disponibilidad. Si no especifica este parámetro, este cmdlet usa la ubicación de trabajo actual.

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

-Script

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

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

-TrustServerCertificate

Indica si el canal se cifrará al pasar la cadena de certificados para validar la confianza.

En la versión 22 del módulo, el valor predeterminado es $true (por compatibilidad con v21). En la versión 23+ del módulo, el valor predeterminado será "$false", que puede crear un cambio importante para los scripts existentes.

Este parámetro es nuevo en la versión 22 del módulo.

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

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

Microsoft.SqlServer.Management.Smo.Server

Puede pasar una instancia de servidor a este cmdlet.

Notas

El servicio de recuperación de datos de alta disponibilidad debe estar habilitado en la instancia del servidor. La réplica de disponibilidad especificada por el parámetro Path debe existir.

Vínculos relacionados

• New-SqlAvailabilityGroup
• Remove-SqlAvailabilityGroup
• Set-SqlAvailabilityGroup
• Switch-SqlAvailabilityGroup
• Test-SqlAvailabilityGroup