Condividi tramite

Join-SqlAvailabilityGroup

  • Riferimento
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>]
    [-ProgressAction <ActionPreference>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Join-SqlAvailabilityGroup
    [-Name] <String>
    [-InputObject] <Server>
    [-ClusterType <AvailabilityGroupClusterType>]
    [-Script]
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [-ProgressAction <ActionPreference>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Descrizione

Il cmdlet Join-SqlAvailabilityGroup unisce 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 a SQL Server, come 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 o un Managed Identity.

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

Questo parametro è nuovo nella versione 22 del modulo.

Tipo:PSObject
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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 gruppi di disponibilità in SQL Server 2016 e versioni successive. Si tratta dell'impostazione predefinita.
  • Nessuno. Il gruppo di disponibilità sarà indipendente dal cluster.
  • Esterno. Il gruppo di disponibilità verrà gestito da un gestore 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 o verrà eseguito un errore.
Tipo:AvailabilityGroupClusterType
Valori accettati:Wsfc, None, External
Posizione:Named
Valore predefinito:Wsfc
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Encrypt

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

Questo valore esegue il mapping alla proprietà EncryptSqlConnectionEncryptOption sull'oggetto SqlConnection del driver Microsoft.Data.SqlClient.

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

Questo parametro è nuovo nella versione 22 del modulo.

Tipo:String
Valori accettati:Mandatory, Optional, Strict
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-HostNameInCertificate

Nome host da usare per convalidare il 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.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

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

Tipo:Server
Posizione:2
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

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

Tipo:String
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Path

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

Tipo:String
Posizione:2
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ProgressAction

Determina in che modo PowerShell risponde agli aggiornamenti dello stato generati da uno script, un cmdlet o un provider, ad esempio le barre di stato generate dal cmdlet Write-Progress. Il cmdlet Write-Progress crea barre di stato che mostrano lo stato di un comando.

Tipo:ActionPreference
Alias:proga
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Script

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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 v21). Nella versione 23+ del modulo, il valore predefinito sarà "$false", che potrebbe creare una modifica di rilievo per gli script esistenti.

Questo parametro è nuovo nella versione 22 del modulo.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.SqlServer.Management.Smo.Server

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

Note

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