New-SqlAvailabilityReplica
Crea una replica di disponibilità
Sintassi
New-SqlAvailabilityReplica
-AvailabilityMode <AvailabilityReplicaAvailabilityMode>
-FailoverMode <AvailabilityReplicaFailoverMode>
-EndpointUrl <String>
[-SessionTimeout <Int32>]
[-ConnectionModeInPrimaryRole <AvailabilityReplicaConnectionModeInPrimaryRole>]
[-ConnectionModeInSecondaryRole <AvailabilityReplicaConnectionModeInSecondaryRole>]
[-BackupPriority <Int32>]
[-ReadOnlyRoutingList <String[]>]
[-ReadonlyRoutingConnectionUrl <String>]
[-SeedingMode <AvailabilityReplicaSeedingMode>]
[-LoadBalancedReadOnlyRoutingList <String[][]>]
[-Name] <String>
[[-Path] <String>]
[-Script]
[-AccessToken <PSObject>]
[-TrustServerCertificate]
[-HostNameInCertificate <String>]
[-Encrypt <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-SqlAvailabilityReplica
-AvailabilityMode <AvailabilityReplicaAvailabilityMode>
-FailoverMode <AvailabilityReplicaFailoverMode>
-EndpointUrl <String>
[-SessionTimeout <Int32>]
[-ConnectionModeInPrimaryRole <AvailabilityReplicaConnectionModeInPrimaryRole>]
[-ConnectionModeInSecondaryRole <AvailabilityReplicaConnectionModeInSecondaryRole>]
[-BackupPriority <Int32>]
[-ReadOnlyRoutingList <String[]>]
[-ReadonlyRoutingConnectionUrl <String>]
[-SeedingMode <AvailabilityReplicaSeedingMode>]
[-LoadBalancedReadOnlyRoutingList <String[][]>]
[-AsTemplate]
[-Version <ServerVersion>]
[-Name] <String>
[-Script]
[-AccessToken <PSObject>]
[-TrustServerCertificate]
[-HostNameInCertificate <String>]
[-Encrypt <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-SqlAvailabilityReplica
-AvailabilityMode <AvailabilityReplicaAvailabilityMode>
-FailoverMode <AvailabilityReplicaFailoverMode>
-EndpointUrl <String>
[-SessionTimeout <Int32>]
[-ConnectionModeInPrimaryRole <AvailabilityReplicaConnectionModeInPrimaryRole>]
[-ConnectionModeInSecondaryRole <AvailabilityReplicaConnectionModeInSecondaryRole>]
[-BackupPriority <Int32>]
[-ReadOnlyRoutingList <String[]>]
[-ReadonlyRoutingConnectionUrl <String>]
[-SeedingMode <AvailabilityReplicaSeedingMode>]
[-LoadBalancedReadOnlyRoutingList <String[][]>]
[-Name] <String>
[-InputObject] <AvailabilityGroup>
[-Script]
[-AccessToken <PSObject>]
[-TrustServerCertificate]
[-HostNameInCertificate <String>]
[-Encrypt <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Descrizione
Il cmdlet New-SqlAvailabilityReplica crea una replica di disponibilità. Eseguire questo cmdlet nell'istanza di SQL Server che ospita la replica primaria.
Per creare una replica di disponibilità prima di creare un gruppo di disponibilità, specificare il parametro AsTemplate . Per aggiungere una replica a un gruppo di disponibilità esistente, il parametro InputObject o Path specifica il gruppo di disponibilità.
Esempio
Esempio 1: Crea una rappresentazione di una replica di disponibilità
PS C:\> $ServerObject = Get-Item "SQLSERVER:\Sql\PrimaryServer\InstanceName"
PS C:\> New-SqlAvailabilityReplica -Name "PrimaryServer\Instance" -EndpointUrl "TCP://PrimaryServerName.domain.com:5022" -FailoverMode Automatic -AvailabilityMode SynchronousCommit -AsTemplate -Version $ServerObject.VersionIn questo esempio si crea una rappresentazione in memoria di una replica di disponibilità. Non viene eseguito alcun commit delle modifiche nel server. È possibile usare questa replica come valore per il parametro AvailabilityReplica di New-SqlAvailabilityGroup
Il primo comando ottiene un'istanza del server primario.
Il secondo comando crea la replica di disponibilità. Questa replica usa l'endpoint di mirroring del database situato nell'URL specificato per comunicare con altre repliche nel gruppo di disponibilità. Questa replica supporta il failover automatico e la modalità di disponibilità con commit sincrono. Il parametro Version specifica la versione dell'istanza del server che ospiterà questa nuova replica.
Esempio 2: Crea una replica di disponibilità che supporta il failover manuale e l'asincronacommit
PS C:\> $ServerObject = Get-Item "SQLSERVER:\Sql\PrimaryServer\InstanceName"
PS C:\> New-SqlAvailabilityReplica -Name "SecondaryServer\Instance" -EndpointUrl "TCP://PrimaryServerName.domain.com:5022" -FailoverMode Manual -AvailabilityMode AsynchronousCommit -AsTemplate -Version $ServerObject.VersionIn questo esempio si crea una rappresentazione in memoria di una replica di disponibilità. Non viene eseguito alcun commit delle modifiche nel server.
Il primo comando ottiene un'istanza del server primario.
Il secondo comando crea la replica di disponibilità. Questa replica usa l'endpoint di mirroring del database situato nell'URL specificato per comunicare con altre repliche nel gruppo di disponibilità. Questa replica supporta il failover manuale e la modalità di disponibilità con commit asincrono. Il parametro Version specifica la versione dell'istanza del server che ospiterà questa nuova replica.
Esempio 3: Aggiungere una replica di disponibilità a un gruppo di disponibilità
PS C:\> New-SqlAvailabilityReplica -Name "SecondaryServer\Instance" -EndpointUrl "TCP://PrimaryServerName.domain.com:5022" -FailoverMode Manual -AvailabilityMode AsynchronousCommit -ConnectionModeInSecondaryRole AllowAllConnections -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG"Questo comando aggiunge una replica di disponibilità a un gruppo di disponibilità esistente denominato 'MainAG'. Questa replica supporta il failover manuale e la modalità di disponibilità con commit asincrono. Nel ruolo secondario questa replica supporta le connessioni di accesso in lettura. Questa configurazione consente di disattivare l'elaborazione di sola lettura in questa replica.
Parametri
-AccessToken
Token di accesso usato per eseguire l'autenticazione per SQL Server, come alternativa all'autenticazione utente/password o a Windows.
Questa operazione può essere usata, 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 |
-AsTemplate
Indica che questo cmdlet crea un oggetto AvailabilityReplica temporaneo in memoria. Specificare questo parametro per creare un gruppo di disponibilità prima di creare una replica di disponibilità. Creare un gruppo di disponibilità usando il cmdlet New-SqlAvailabilityGroup . Specificare la replica di disponibilità temporanea come valore del parametro AvailabilityReplica .
Se si specifica AsTemplate, questo cmdlet ignora i valori per i parametri InputObject e Path .
Se si specifica questo parametro, è necessario specificare anche una versione SQL Server per il parametro Version oppure la sessione corrente deve avere una connessione attiva a un'istanza.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AvailabilityMode
Specifica la modalità di disponibilità della replica.
È possibile specificare un valore di $Null.
| Type: | AvailabilityReplicaAvailabilityMode |
| Accepted values: | AsynchronousCommit, SynchronousCommit, Unknown, ConfigurationOnly |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BackupPriority
Specifica la priorità desiderata delle repliche nell'esecuzione di backup. I valori accettabili per questo parametro sono interi da 0 a 100. Del set di repliche online e disponibili, la replica con la priorità più alta esegue il backup.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| 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 |
-ConnectionModeInPrimaryRole
Specifica come la replica di disponibilità gestisce le connessioni quando nel ruolo primario.
I valori validi per questo parametro sono:
- AllowReadWriteConnections. Consente connessioni di lettura/scrittura
- AllowAllConnections. Consente tutte le connessioni
| Type: | AvailabilityReplicaConnectionModeInPrimaryRole |
| Accepted values: | AllowAllConnections, AllowReadWriteConnections, Unknown |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConnectionModeInSecondaryRole
Specifica come la replica di disponibilità gestisce le connessioni quando nel ruolo secondario. I valori validi per questo parametro sono:
- AllowNoConnections. Non consentite le connessioni
- AllowReadIntentConnectionsOnly. Consente solo connessioni con finalità di lettura
- AllowAllConnections. Consente tutte le connessioni
| Type: | AvailabilityReplicaConnectionModeInSecondaryRole |
| Accepted values: | AllowNoConnections, AllowReadIntentConnectionsOnly, AllowAllConnections, Unknown |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Encrypt
Tipo di crittografia da usare durante 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 la compatibilità con v21). 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 |
-EndpointUrl
Specifica l'URL dell'endpoint di mirroring del database. Questo URL è un indirizzo TCP nel formato seguente:
TCP://system-address:port
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FailoverMode
Specifica la modalità di failover.
È possibile specificare un valore di $Null
| Type: | AvailabilityReplicaFailoverMode |
| Accepted values: | Automatic, Manual, External, Unknown |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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 Force Encryption 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 Force Encryption.
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 gruppo di disponibilità, come oggetto AvailabilityGroup , a cui appartiene la replica.
| Type: | AvailabilityGroup |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-LoadBalancedReadOnlyRoutingList
Specifica l'elenco di routing di sola lettura con carico bilanciato.
L'elenco di routing è un elenco di set con bilanciamento del carico, che a sua volta sono elenchi di repliche.
Ad esempio, passando un valore come
@('Server1','Server2'),@('Server3'),@('Server4')
indica il passaggio di 3 set con bilanciamento del carico: 1 con 2 repliche (Server1 e Server2) e 2 con una sola (Server3 e Server4, rispettivamente).
In fase di esecuzione, SQL Server esaminerà in sequenza tutti i set con bilanciamento del carico fino a trovare uno in modo che almeno su replica sia disponibile e usarlo per il bilanciamento del carico.
Nell'esempio precedente, se server1 e Server2 non sono disponibili, ma Server3 è, SQL Server selezionerà Server3.
Questo cmdlet imposta solo l'elenco di routing di sola lettura e non verifica la disponibilità delle repliche specificate.
| Type: | String[][] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Specifica un nome per la replica di disponibilità nel formato seguente: Computer\Istanza
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
Specifica il percorso del gruppo di disponibilità a cui appartiene la replica. 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 |
-ReadonlyRoutingConnectionUrl
Specifica il nome di dominio completo (FQDN) e la porta da usare durante il routing alla replica per le connessioni di sola lettura, come nell'esempio seguente: TCP://DBSERVER8.manufacturing.Contoso.com:7024
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ReadOnlyRoutingList
Specifica un elenco ordinato di nomi del server di replica che rappresentano la sequenza di probe da usare per la directory di connessione durante il reindirizzamento delle connessioni di sola lettura tramite questa replica di disponibilità. Questo parametro si applica se la replica di disponibilità è la replica primaria corrente del gruppo di disponibilità.
| Type: | String[] |
| 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 |
-SeedingMode
Specifica in che modo viene eseguito il seeding iniziale della replica secondaria.
Valori consentiti:
- Automatico. Abilita il seeding diretto. Questo metodo esegue il seeding della replica secondaria in rete. Non richiede l'esecuzione del backup e il ripristino di una copia del database primario nella replica.
- manuale. Specifica il seeding manuale. Questo metodo richiede la creazione di un backup del database nella replica primaria e il ripristino manuale del backup nella replica secondaria.
| Type: | AvailabilityReplicaSeedingMode |
| Accepted values: | Automatic, Manual |
| Position: | Named |
| Default value: | Manual |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SessionTimeout
Specifica il periodo di tempo, espresso in secondi, per attendere una risposta tra la replica primaria e la replica prima che la connessione non riesca.
| Type: | Int32 |
| 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 |
-Version
Specifica una versione di SQL Server. Se si specifica il parametro AsTemplate , è necessario specificare una versione. L'oggetto modello viene creato in modalità progettazione in un server che include questa versione. È possibile specificare un numero intero o una stringa, come negli esempi seguenti (SQL Server 2017):
- 14
- '14.0.0'
| Type: | ServerVersion |
| 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.AvailabilityGroup
È possibile passare un gruppo di disponibilità a questo cmdlet.
Output
Microsoft.SqlServer.Management.Smo.AvailabilityReplica
Questo cmdlet restituisce una replica di disponibilità.