New-SqlAvailabilityReplica
Crea una replica di disponibilità.
Sintassi
ByPath (impostazione predefinita).
New-SqlAvailabilityReplica
[-Name] <String>
[[-Path] <String>]
-AvailabilityMode <AvailabilityReplicaAvailabilityMode>
-FailoverMode <AvailabilityReplicaFailoverMode>
-EndpointUrl <String>
[-SessionTimeout <Int32>]
[-ConnectionModeInPrimaryRole <AvailabilityReplicaConnectionModeInPrimaryRole>]
[-ConnectionModeInSecondaryRole <AvailabilityReplicaConnectionModeInSecondaryRole>]
[-BackupPriority <Int32>]
[-ReadOnlyRoutingList <String[]>]
[-ReadonlyRoutingConnectionUrl <String>]
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
AsTemplate
New-SqlAvailabilityReplica
[-Name] <String>
-AvailabilityMode <AvailabilityReplicaAvailabilityMode>
-FailoverMode <AvailabilityReplicaFailoverMode>
-EndpointUrl <String>
[-SessionTimeout <Int32>]
[-ConnectionModeInPrimaryRole <AvailabilityReplicaConnectionModeInPrimaryRole>]
[-ConnectionModeInSecondaryRole <AvailabilityReplicaConnectionModeInSecondaryRole>]
[-BackupPriority <Int32>]
[-ReadOnlyRoutingList <String[]>]
[-ReadonlyRoutingConnectionUrl <String>]
[-AsTemplate]
[-Version <ServerVersion>]
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
New-SqlAvailabilityReplica
[-Name] <String>
[-InputObject] <AvailabilityGroup>
-AvailabilityMode <AvailabilityReplicaAvailabilityMode>
-FailoverMode <AvailabilityReplicaFailoverMode>
-EndpointUrl <String>
[-SessionTimeout <Int32>]
[-ConnectionModeInPrimaryRole <AvailabilityReplicaConnectionModeInPrimaryRole>]
[-ConnectionModeInSecondaryRole <AvailabilityReplicaConnectionModeInSecondaryRole>]
[-BackupPriority <Int32>]
[-ReadOnlyRoutingList <String[]>]
[-ReadonlyRoutingConnectionUrl <String>]
[-Script]
[-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.Version
In questo esempio viene creata una rappresentazione in memoria di una replica di disponibilità. Non viene eseguito il commit di modifiche al 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 del mirroring del database che si trova 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 il commit asincrono
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.Version
In questo esempio viene creata una rappresentazione in memoria di una replica di disponibilità. Non viene eseguito il commit di modifiche al server.
Il primo comando ottiene un'istanza del server primario.
Il secondo comando crea la replica di disponibilità. Questa replica usa l'endpoint del mirroring del database che si trova 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 eseguire l'offload dell'elaborazione di sola lettura in questa replica.
Parametri
-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 di SQL Server per il parametro Version oppure la sessione corrente deve avere una connessione attiva a un'istanza di .
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
AsTemplate
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-AvailabilityMode
Specifica la modalità di disponibilità della replica. I valori accettabili per questo parametro sono:
- SynchronousCommit
- AsynchronousCommit
È possibile specificare un valore di $Null.
Proprietà dei parametri
| Tipo: | AvailabilityReplicaAvailabilityMode |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-BackupPriority
Specifica la priorità desiderata delle repliche nell'esecuzione dei backup. I valori accettabili per questo parametro sono: numeri interi compresi tra 0 e 100. Del set di repliche online e disponibili, la replica con la priorità più alta esegue il backup.
Proprietà dei parametri
| Tipo: | Int32 |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Confirm
Richiede conferma prima di eseguire il cmdlet.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | cfr |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ConnectionModeInPrimaryRole
Specifica il modo in cui la replica di disponibilità gestisce le connessioni quando si trova nel ruolo primario. I valori accettabili per questo parametro sono:
- AllowReadWriteConnections. Consenti connessioni di lettura/scrittura
- AllowAllConnections. Consenti tutte le connessioni
Proprietà dei parametri
| Tipo: | AvailabilityReplicaConnectionModeInPrimaryRole |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ConnectionModeInSecondaryRole
Specifica il modo in cui la replica di disponibilità gestisce le connessioni quando nel ruolo secondario. I valori accettabili per questo parametro sono:
- AllowNoConnections. Non consente connessioni
- AllowReadIntentConnectionsOnly. Consente solo connessioni con finalità di lettura
- AllowAllConnections. Consente tutte le connessioni
Proprietà dei parametri
| Tipo: | AvailabilityReplicaConnectionModeInSecondaryRole |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-EndpointUrl
Specifica l'URL dell'endpoint del mirroring del database. Questo URL è un indirizzo TCP nel formato seguente:
TCP://system-address:port
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-FailoverMode
Specifica la modalità di failover. I valori accettabili per questo parametro sono:
- Automatico
- Manuale È possibile specificare un valore di $Null.
Proprietà dei parametri
| Tipo: | AvailabilityReplicaFailoverMode |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-InputObject
Specifica il gruppo di disponibilità, come oggetto AvailabilityGroup , a cui appartiene la replica.
Proprietà dei parametri
| Tipo: | AvailabilityGroup |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
ByObject
| Posizione: | 3 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Name
Specifica un nome per la replica di disponibilità nel formato seguente:
Computer\Istanza
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 2 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | 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.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
ByPath
| Posizione: | 3 |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | 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
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ReadOnlyRoutingList
Specifica un elenco ordinato di nomi di 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à.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Script
Indica che questo cmdlet restituisce un Transact-SQL script che esegue l'attività eseguita da questo cmdlet.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-SessionTimeout
Specifica la quantità di tempo, espressa in secondi, per attendere una risposta tra la replica primaria e la replica prima che la connessione non riesca.
Proprietà dei parametri
| Tipo: | Int32 |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | 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:
- 13
- "13.0.0"
Proprietà dei parametri
| Tipo: | ServerVersion |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
AsTemplate
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Wi |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
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à.