Switch-SqlAvailabilityGroup
Avvia un failover di un gruppo di disponibilità in una replica secondaria.
Sintassi
ByPath (impostazione predefinita).
Switch-SqlAvailabilityGroup
[[-Path] <String[]>]
[-AllowDataLoss]
[-Force]
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
Switch-SqlAvailabilityGroup
[-InputObject] <AvailabilityGroup[]>
[-AllowDataLoss]
[-Force]
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Il cmdlet Switch-SqlAvailabilityGroup avvia un failover di un gruppo di disponibilità in una replica secondaria specificata. Eseguire questo cmdlet nella replica secondaria di destinazione. Dopo il failover, la replica secondaria diventa la replica primaria.
Esempio
Esempio 1: Eseguire il failover di un gruppo di disponibilità
PS C:\> Switch-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\SecondaryServer\InstanceName\AvailabilityGroups\MainAG"
Questo comando esegue un failover manuale del gruppo di disponibilità MainAG nell'istanza del server denominata SecondaryServer\InstanceName. Questo comando non consente la perdita di dati. Eseguire questo comando nell'istanza del server che ospita la replica secondaria in cui eseguire il failover.
Esempio 2: Forzare il failover di un gruppo di disponibilità
PS C:\> Switch-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\SecondaryServer\InstanceName\AvailabilityGroups\MainAG" -AllowDataLoss
Questo comando esegue un failover manuale del gruppo di disponibilità MainAG nell'istanza del server denominata SecondaryServer\InstanceName. Il comando specifica il parametro AllowDataLoss . Pertanto, il failover ha il potenziale di perdita di dati e il comando richiede la conferma. Specificare il parametro Force per ignorare la conferma.
Esempio 3: Creare uno script per eseguire il failover di un gruppo di disponibilità
PS C:\>Switch-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\SecondaryServer\InstanceName\AvailabilityGroups\MainAG" -Script
Questo comando crea uno script Transact-SQL che esegue un failover manuale del gruppo di disponibilità MainAG nell'istanza del server denominata SecondaryServer\InstanceName. Lo script non consente la perdita di dati. Il comando non causa il failover.
Parametri
-AllowDataLoss
Indica che questo cmdlet avvia un failover forzato nella replica secondaria di destinazione. La perdita di dati è possibile. A meno che non si specifichi il parametro Force o Script , il cmdlet richiede la conferma.
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 |
-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 |
-Force
Forza l'esecuzione del comando senza chiedere conferma dell'utente. Questo cmdlet richiede la conferma solo se si specifica il parametro AllowDataLoss .
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 |
-InputObject
Specifica il gruppo di disponibilità su cui viene eseguito il failover di questo cmdlet.
Proprietà dei parametri
| Tipo: | AvailabilityGroup[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
ByObject
| Posizione: | 2 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Path
Specifica il percorso del gruppo di disponibilità di cui viene eseguito il failover di questo cmdlet. 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: | 2 |
| 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 |
-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.