Switch-SqlAvailabilityGroup
Memulai failover grup ketersediaan ke replika sekunder.
Sintaks
ByPath (Default)
Switch-SqlAvailabilityGroup
[[-Path] <String[]>]
[-AllowDataLoss]
[-Force]
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
Switch-SqlAvailabilityGroup
[-InputObject] <AvailabilityGroup[]>
[-AllowDataLoss]
[-Force]
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Deskripsi
Cmdlet Switch-SqlAvailabilityGroup memulai failover grup ketersediaan ke replika sekunder tertentu. Jalankan cmdlet ini pada replika sekunder target. Setelah failover, replika sekunder menjadi replika utama.
Contoh
Contoh 1: Failover grup ketersediaan
PS C:\> Switch-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\SecondaryServer\InstanceName\AvailabilityGroups\MainAG"
Perintah ini melakukan failover manual grup ketersediaan MainAG ke instans server bernama SecondaryServer\InstanceName. Perintah ini tidak memperbolehkan kehilangan data. Jalankan perintah ini pada instans server yang menghosting replika sekunder yang akan di-failover.
Contoh 2: Memaksa grup ketersediaan untuk melakukan failover
PS C:\> Switch-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\SecondaryServer\InstanceName\AvailabilityGroups\MainAG" -AllowDataLoss
Perintah ini melakukan failover manual grup ketersediaan MainAG ke instans server bernama SecondaryServer\InstanceName. Perintah menentukan parameter AllowDataLoss . Oleh karena itu, failover memiliki potensi kehilangan data, dan perintah meminta konfirmasi kepada Anda. Tentukan parameter Paksa untuk melewati konfirmasi.
Contoh 3: Membuat skrip untuk melakukan failover pada grup ketersediaan
PS C:\>Switch-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\SecondaryServer\InstanceName\AvailabilityGroups\MainAG" -Script
Perintah ini membuat skrip Transact-SQL yang melakukan failover manual grup ketersediaan MainAG ke instans server bernama SecondaryServer\InstanceName. Skrip tidak mengizinkan kehilangan data. Perintah tidak menyebabkan failover.
Parameter
-AllowDataLoss
Menunjukkan bahwa cmdlet ini memulai failover paksa ke replika sekunder target. Kehilangan data dimungkinkan. Kecuali Anda menentukan parameter Paksa atau Skrip , cmdlet meminta konfirmasi kepada Anda.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Confirm
Meminta konfirmasi sebelum menjalankan cmdlet.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | Cf |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Force
Memaksa perintah untuk dijalankan tanpa meminta konfirmasi pengguna. Cmdlet ini meminta konfirmasi hanya jika Anda menentukan parameter AllowDataLoss .
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-InputObject
Menentukan grup ketersediaan yang gagal oleh cmdlet ini.
Properti parameter
| Jenis: | AvailabilityGroup[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
ByObject
| Position: | 2 |
| Wajib: | True |
| Nilai dari alur: | True |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Path
Menentukan jalur grup ketersediaan yang gagal oleh cmdlet ini. Jika Anda tidak menentukan parameter ini, cmdlet ini menggunakan lokasi kerja saat ini.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
ByPath
| Position: | 2 |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Script
Menunjukkan bahwa cmdlet ini mengembalikan skrip Transact-SQL yang melakukan tugas yang dilakukan cmdlet ini.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-WhatIf
Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | wi |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
CommonParameters
Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.
Input
Microsoft.SqlServer.Management.Smo.AvailabilityGroup
Anda dapat meneruskan grup ketersediaan ke cmdlet ini.