Join-SqlAvailabilityGroup

Modulo:

SQLServer

Aggiunge la replica secondaria locale a un gruppo di disponibilità.

Sintassi

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>]

Descrizione

Il cmdlet Join-SqlAvailabilityGroup aggiunge la replica secondaria locale a un gruppo di disponibilità.

Eseguire questo cmdlet in un'istanza di SQL Server che ospita una replica secondaria non unita al gruppo di disponibilità.

Esempio

Esempio 1: Aggiungere una replica secondaria a un gruppo di disponibilità

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

Questo comando aggiunge una replica secondaria al gruppo di disponibilità denominato "MainAG". Questa istanza del server deve ospitare una replica secondaria in questo gruppo di disponibilità.

Esempio 2: Creare uno script che unisce una replica secondaria a un gruppo di disponibilità

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

Questo comando crea uno script Transact-SQL che unisce una replica secondaria al gruppo di disponibilità denominato "MainAG".

Parametri

-AccessToken

Token di accesso usato per eseguire l'autenticazione per SQL Server, in alternativa all'autenticazione utente/password o Windows.

Può essere usato, ad esempio, per connettersi a SQL Azure DB e SQL Azure Managed Instance usando un Service Principal oggetto o .Managed Identity

Il parametro da usare può essere una stringa che rappresenta il token o un PSAccessToken oggetto restituito eseguendo Get-AzAccessToken -ResourceUrl https://database.windows.net.

Questo parametro è nuovo nella versione 22 del modulo.

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

-ClusterType

Tipo di cluster che esegue il backup del gruppo di disponibilità. I valori possibili sono:

• Wsfc. Il gruppo di disponibilità verrà integrato nel cluster di failover di Windows Server. Questo è il modo in cui vengono creati i gruppi di disponibilità in SQL Server 2016 e versioni successive. Questo è il valore predefinito.
• Nessuno. Il gruppo di disponibilità sarà indipendente dal cluster.
• Esterno. Il gruppo di disponibilità verrà gestito da un gestore di cluster che non è un cluster di failover di Windows Server, ad esempio Pacemaker in Linux. Questa funzionalità è supportata in SQL Server 2017 e versioni successive. Quando la destinazione è SQL Server in Linux, è necessario specificare questo valore oppure si verifica un errore.

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

-Confirm

Richiede la conferma dell'utente prima di eseguire il cmdlet.

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

-Encrypt

Tipo di crittografia da utilizzare per la connessione a SQL Server.

Questo valore esegue il Encrypt mapping alla proprietà SqlConnectionEncryptOption nell'oggetto SqlConnection del driver Microsoft.Data.SqlClient.

Nella versione 22 del modulo il valore predefinito è Optional (per compatibilità con la versione 21). Nella versione 23+ del modulo il valore predefinito sarà "Obbligatorio", che può creare una modifica di rilievo per gli script esistenti.

Questo parametro è nuovo nella versione 22 del modulo.

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

-HostNameInCertificate

Nome host da usare per la convalida del certificato TLS/SSL di SQL Server. È necessario passare questo parametro se l'istanza di SQL Server è abilitata per Forza crittografia e si vuole connettersi a un'istanza usando nome host/nome breve. Se questo parametro viene omesso, è necessario passare il nome di dominio completo (FQDN) a -ServerInstance per connettersi a un'istanza di SQL Server abilitata per Forza crittografia.

Questo parametro è nuovo nella versione 22 del modulo.

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

-InputObject

Specifica il server che ospita l'istanza di SQL Server che ospita la replica secondaria aggiunta a questo cmdlet al gruppo di disponibilità.

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

-Name

Specifica il nome del gruppo di disponibilità a cui questo cmdlet aggiunge una replica secondaria.

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

-Path

Specifica il percorso dell'istanza di SQL Server che ospita la replica secondaria aggiunta a questo cmdlet al gruppo di disponibilità. Se non si specifica questo parametro, questo cmdlet usa la posizione di lavoro corrente.

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

-Script

Indica che questo cmdlet restituisce uno script Transact-SQL che esegue l'attività eseguita da questo cmdlet.

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

-TrustServerCertificate

Indica se il canale verrà crittografato durante il bypass della catena di certificati per convalidare l'attendibilità.

Nella versione 22 del modulo il valore predefinito è $true (per compatibilità con la versione 21). Nella versione 23+ del modulo il valore predefinito sarà "$false", che può creare una modifica di rilievo per gli script esistenti.

Questo parametro è nuovo nella versione 22 del modulo.

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

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.

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

Input

Microsoft.SqlServer.Management.Smo.Server

È possibile passare un'istanza del server a questo cmdlet.

Note

Il servizio di ripristino dei dati a disponibilità elevata deve essere abilitato nell'istanza del server. La replica di disponibilità specificata dal parametro Path deve esistere.

Collegamenti correlati

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