New-SqlAvailabilityGroup
Crea un gruppo di disponibilità.
Sintassi
New-SqlAvailabilityGroup
-AvailabilityReplica <AvailabilityReplica[]>
[-Database <String[]>]
[-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
[-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
[-HealthCheckTimeout <Int32>]
[-BasicAvailabilityGroup]
[-ContainedAvailabilityGroup]
[-ReuseSystemDatabases]
[-DatabaseHealthTrigger]
[-DtcSupportEnabled]
[-ClusterType <AvailabilityGroupClusterType>]
[-RequiredSynchronizedSecondariesToCommit <Int32>]
[-Name] <String>
[[-Path] <String>]
[-Script]
[-AccessToken <PSObject>]
[-TrustServerCertificate]
[-HostNameInCertificate <String>]
[-Encrypt <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-SqlAvailabilityGroup
-AvailabilityReplica <AvailabilityReplica[]>
[-Database <String[]>]
[-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
[-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
[-HealthCheckTimeout <Int32>]
[-BasicAvailabilityGroup]
[-ContainedAvailabilityGroup]
[-ReuseSystemDatabases]
[-DatabaseHealthTrigger]
[-DtcSupportEnabled]
[-ClusterType <AvailabilityGroupClusterType>]
[-RequiredSynchronizedSecondariesToCommit <Int32>]
[-Name] <String>
[-InputObject] <Server>
[-Script]
[-AccessToken <PSObject>]
[-TrustServerCertificate]
[-HostNameInCertificate <String>]
[-Encrypt <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Descrizione
Il cmdlet New-SqlAvailabilityGroup crea un gruppo di disponibilità in Always On gruppi di disponibilità.
Il parametro InputObject o Path specifica il server che ospita la replica primaria iniziale.
Module requirements: version 21+ on PowerShell 5.1; version 22+ on PowerShell 7.x.
Esempio
Esempio 1: Creare un gruppo di disponibilità
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")Il primo comando ottiene un'istanza di SQL Server nel server primario e quindi la archivia nella variabile $PrimaryServer.
Il quarto comando crea una replica che include l'istanza del server secondario usando New-SqlAvailabilityReplica e quindi la archivia nella variabile $SecondaryReplica.
Il comando specifica la versione dell'istanza del server utilizzando la proprietà Version di $SecondaryServer.
Esempio 2: Creare un gruppo di disponibilità supportato da WSFC
# Get server
PS C:\> cd 'SQLSERVER:\SQL\some-hostname\Default'
PS SQLSERVER:\SQL\some-hostname\Default> $server = Get-Item $PWD
# Create primary replica
PS SQLSERVER:\SQL\some-hostname\Default> $primaryReplica = New-SqlAvailabilityReplica -Name 'some-hostname' -EndpointUrl 'tcp://some-hostname:5022' -FailoverMode Automatic -AvailabilityMode SynchronousCommit -AsTemplate
# Create AG with explicit cluster type WSFC (same as not passing -ClusterType, since it is the default value)
PS SQLSERVER:\SQL\some-hostname\Default> $server | New-SqlAvailabilityGroup -Name 'ag1' -AvailabilityReplica $PrimaryReplica -Script -ClusterType WsfcEsempio 3: Creare un cluster indipendente dai gruppi di disponibilità
# Get server
PS C:\> CD 'SQLSERVER:\SQL\some-hostname\Default'
PS SQLSERVER:\SQL\some-hostname\Default> $server = Get-Item $PWD
# Create primary replica
PS SQLSERVER:\SQL\some-hostname\Default> $primaryReplica = New-SqlAvailabilityReplica -Name 'some-hostname' -EndpointUrl 'tcp://some-hostname:5022' -FailoverMode Automatic -AvailabilityMode SynchronousCommit -AsTemplate
# Create AG cluster group independent
PS SQLSERVER:\SQL\some-hostname\Default> $server | New-SqlAvailabilityGroup -Name 'ag1' -AvailabilityReplica $PrimaryReplica -Script -ClusterType NoneEsempio 4: Creare un gruppo di disponibilità impostando il numero di SYNCHRONOUS_COMMIT database secondari che devono essere disponibili per il commit delle transazioni nel database primario
# Get server
PS C:\> Get-Item 'SQLSERVER:\SQL\some-hostname\Default'
# Create primary replica
PS C:\> $primaryReplica = New-SqlAvailabilityReplica -Name 'some-hostname' -EndpointUrl 'tcp://some-hostname:5022' -FailoverMode Automatic -AvailabilityMode SynchronousCommit -AsTemplate
# Create AG with RequiredSynchronizedSecondariesToCommit = 3
PS C:\> $server | New-SqlAvailabilityGroup -Name 'ag1' -AvailabilityReplica $PrimaryReplica -RequiredSynchronizedSecondariesToCommit 3Nota: verrà generata un'eccezione se il parametro -RequiredSynchronizedSecondariesToCommit viene usato quando la versione del server di destinazione è SQL Server 2016 o versione successiva.
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 |
-AutomatedBackupPreference
Specifica la preferenza di backup automatizzata per il gruppo di disponibilità.
I valori validi per questo parametro sono:
- Primario. Specifica che i backup vengono sempre eseguiti nella replica primaria. Questa opzione supporta l'uso di funzionalità non disponibili quando il backup viene eseguito in una replica secondaria, ad esempio backup differenziali.
- SecondaryOnly. Specifica che i backup non vengono mai eseguiti nelle repliche primarie. Se la replica primaria è l'unica replica online, il backup non viene eseguito.
- Secondario. Specifica che i backup vengono eseguiti nelle repliche secondarie, a meno che la replica primaria non sia l'unica replica online. Successivamente, il backup viene eseguito nella replica primaria.
- Nessuno. Specifica che lo stato primario o secondario non viene preso in considerazione quando si decide quale replica esegue i backup. Al contrario, la priorità di backup e lo stato online determinano quali repliche eseguono backup.
| Type: | AvailabilityGroupAutomatedBackupPreference |
| Accepted values: | Primary, SecondaryOnly, Secondary, None, Unknown |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AvailabilityReplica
Specifica una matrice di repliche di disponibilità incluse nel gruppo di disponibilità. Per ottenere un valore AvailabilityReplica, usare il cmdlet New-SqlAvailabilityReplica . Specificare il parametro AsTemplate .
| Type: | AvailabilityReplica[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BasicAvailabilityGroup
Specifica se creare ( advanced impostazione predefinita) o un basic gruppo di disponibilità.
| Type: | SwitchParameter |
| 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.
Nota: verrà generata un'eccezione se il parametro -ClusterType viene usato quando il server di destinazione è SQL Server 2016 e versioni successive.
| 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 |
-ContainedAvailabilityGroup
Usato per creare un gruppo di disponibilità indipendente. Questa opzione consente di creare un gruppo di disponibilità con i relativi database master e msdb, che vengono mantenuti sincronizzati nel set di repliche nel gruppo di disponibilità. Questo parametro può essere usato con il relativo complementare -ReuseSystemDatabases.
Questo parametro è consentito solo quando il SQL Server di destinazione supporta i gruppi di disponibilità indipendenti (SQL 2022 e versioni successive). Il tentativo di usare è rispetto alle versioni di SQL che non supportano i gruppi di disponibilità indipendenti causerebbe la generazione di un errore da parte del cmdlet.
Questo parametro è disponibile solo nella versione 22+ del modulo.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Database
Specifica una matrice di database utente di lettura/scrittura locali. Questi database devono usare il modello di recupero con registrazione completa e non devono usare AUTO_CLOSE. Questi database non possono appartenere a un altro gruppo di disponibilità e non possono essere configurati per il mirroring del database. È necessario specificare un valore per questo parametro.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DatabaseHealthTrigger
Specifica se attivare un failover automatico del gruppo di disponibilità se una replica di database utente all'interno di un gruppo di disponibilità rileva una condizione di errore del database.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DtcSupportEnabled
Specifica se i database all'interno di un gruppo di disponibilità vengono registrati con MSDTC a livello di istanza (impostazione predefinita) o a livello di database.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 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 |
-FailureConditionLevel
Specifica il comportamento di failover automatico del gruppo di disponibilità. I valori validi per questo parametro sono:
- OnServerDown. Failover o riavvio se il servizio SQL Server si arresta.
- OnServerUnresponsive. Failover o riavvio se viene soddisfatta una condizione di valore inferiore, oltre a quando il servizio SQL Server è connesso al cluster e viene superata la soglia HealthCheckTimeout oppure se la replica di disponibilità attualmente nel ruolo primario si trova in uno stato di errore.
- OnCriticalServerError. Failover o riavvio se viene soddisfatta una condizione di valore inferiore, oltre a quando si verifica un errore interno critico del server, che includono una condizione di memoria insufficiente, una violazione grave dell'accesso in scrittura o un dump eccessivo.
- OnModerateServerError. Failover o riavvio se viene soddisfatta una condizione di valore inferiore, più se si verifica un errore moderato del server, che include una condizione persistente di memoria insufficiente.
- OnAnyQualifiedFailureConditions. Failover o riavvio se viene soddisfatta una condizione di valore inferiore, più se si verifica una condizione di errore idonea, che include l'esaurimento del thread di lavoro del motore e il deadlock non risolvibile rilevato.
| Type: | AvailabilityGroupFailureConditionLevel |
| Accepted values: | OnServerDown, OnServerUnresponsive, OnCriticalServerErrors, OnModerateServerErrors, OnAnyQualifiedFailureCondition, Unknown |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HealthCheckTimeout
Specifica il periodo di tempo, espresso in millisecondi, dopo il quale Always On gruppi di disponibilità dichiarano che un server non risponde non integro.
| Type: | Int32 |
| 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 l'istanza di SQL Server che ospita la replica primaria del gruppo di disponibilità creato da questo cmdlet.
| 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à creato da questo cmdlet.
| 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 primaria iniziale del gruppo di disponibilità creato da questo cmdlet. Se non si specifica questo parametro, questo cmdlet usa la posizione di lavoro corrente. Se si specifica un valore, il percorso deve esistere.
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RequiredSynchronizedSecondariesToCommit
Numero di repliche secondarie di commit sincrono che devono essere disponibili per poter eseguire il commit nel database primario.
Se un SYNCHRONOUS_COMMIT database secondario viene disconnesso dal database primario per un certo periodo di tempo, il database primario lo abbassa per ASYNCHRONOUS_COMMIT evitare il blocco dei commit. Se il database primario diventa quindi non disponibile e l'utente vuole eseguire il failover in uno di questi database secondari, può comportare una perdita di dati. Impostando RequiredSynchronizedSecondariesToCommit su un numero, l'utente può impedire la perdita di dati perché il database primario inizierà a bloccare i commit se troppi database secondari vengono abbassati di livello su ASYNCHRONOUS_COMMIT.
Il valore predefinito di questa impostazione è 0, il che significa che il database primario non bloccherà mai i commit. Questo comportamento è identico a quello precedente SQL Server 2017.
| Type: | Int32 |
| Position: | Named |
| Default value: | 0 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ReuseSystemDatabases
Questo parametro fa sì che i database contenuti master e msdb di una versione precedente del gruppo di disponibilità vengano usati nella creazione di questo nuovo gruppo di disponibilità.
Se si tenta di usare questo parametro senza specificare -ContainedAvailabilityGroup non è consentito, il cmdlet genera un errore.
Questo parametro è disponibile solo nella versione 22+ del modulo.
| Type: | SwitchParameter |
| Position: | Named |
| 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.
Output
Microsoft.SqlServer.Management.Smo.AvailabilityGroup
Questo cmdlet restituisce un gruppo di disponibilità.