Set-SqlAvailabilityReplica
Mengatur pengaturan pada replika ketersediaan.
Sintaks
ByPath (Default)
Set-SqlAvailabilityReplica
[[-Path] <String>]
[-AvailabilityMode <AvailabilityReplicaAvailabilityMode>]
[-FailoverMode <AvailabilityReplicaFailoverMode>]
[-EndpointUrl <String>]
[-SessionTimeout <Int32>]
[-ConnectionModeInPrimaryRole <AvailabilityReplicaConnectionModeInPrimaryRole>]
[-ConnectionModeInSecondaryRole <AvailabilityReplicaConnectionModeInSecondaryRole>]
[-BackupPriority <Int32>]
[-ReadOnlyRoutingList <String[]>]
[-ReadonlyRoutingConnectionUrl <String>]
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
Set-SqlAvailabilityReplica
[-InputObject] <AvailabilityReplica>
[-AvailabilityMode <AvailabilityReplicaAvailabilityMode>]
[-FailoverMode <AvailabilityReplicaFailoverMode>]
[-EndpointUrl <String>]
[-SessionTimeout <Int32>]
[-ConnectionModeInPrimaryRole <AvailabilityReplicaConnectionModeInPrimaryRole>]
[-ConnectionModeInSecondaryRole <AvailabilityReplicaConnectionModeInSecondaryRole>]
[-BackupPriority <Int32>]
[-ReadOnlyRoutingList <String[]>]
[-ReadonlyRoutingConnectionUrl <String>]
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Deskripsi
Set cmdlet Set-SqlAvailabilityReplica atau memodifikasi berbagai properti untuk replika ketersediaan. Jalankan cmdlet ini pada instans server yang menghosting replika utama.
Contoh
Contoh 1: Mengubah mode ketersediaan replika dan failover otomatis
PS C:\> Set-SqlAvailabilityReplica -AvailabilityMode "SynchronousCommit" -FailoverMode Automatic -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityReplicas\Replica02"
Perintah ini memodifikasi replika bernama Replica02 dalam grup ketersediaan bernama MainAG untuk menggunakan mode ketersediaan penerapan sinkron dan untuk mendukung failover otomatis.
Contoh 2: Mengubah replika untuk mendukung failover manual paksa
PS C:\> Set-SqlAvailabilityReplica -AvailabilityMode AsynchronousCommit -FailoverMode Manual -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityReplicas\Replica02"
Perintah ini memodifikasi replika bernama Replica02 dalam grup ketersediaan bernama MainAG untuk menggunakan mode ketersediaan penerapan asinkron dan untuk mendukung hanya failover manual paksa, yang dapat menyebabkan kehilangan data.
Contoh 3: Izinkan semua koneksi dalam peran sekunder
PS C:\> Set-SqlAvailabilityReplica -ConnectionModeInSecondaryRole AllowAllConnections -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityReplicas\Replica02"
Perintah ini memodifikasi replika 'Replica02' dalam grup ketersediaan MainAG untuk memungkinkan semua koneksi dalam peran sekunder. Ini memungkinkan Anda membongkar beban kerja pemrosesan data baca-saja ke replika sekunder.
Contoh 4: Mengonfigurasi replika utama dan replika sekunder untuk perutean baca-saja
PS C:\> Set-Location "SQLSERVER:\SQL\PrimaryServer\default\AvailabilityGroups\MainAG"
C:\PS> $PrimaryReplica = Get-Item "AvailabilityReplicas\PrimaryServer"
C:\PS> $SecondaryReplica = Get-Item "AvailabilityReplicas\SecondaryServer"
C:\PS> Set-SqlAvailabilityReplica -ReadOnlyRoutingConnectionUrl "TCP://PrimaryServer.domain.com:5022" -InputObject $PrimaryReplica
C:\PS> Set-SqlAvailabilityReplica -ReadOnlyRoutingConnectionUrl "TCP://SecondaryServer.domain.com:5022" -InputObject $SecondaryReplica
C:\PS> Set-SqlAvailabilityReplica -ReadOnlyRoutingList "SecondaryServer","PrimaryServer" -InputObject $PrimaryReplica
Perintah pertama mengubah lokasi ke lokasi di penyedia SQLSERVER: .
Perintah kedua mendapatkan replika untuk server utama, lalu menyimpannya dalam variabel $PrimaryReplica.
Perintah ketiga mendapatkan replika untuk server sekunder, lalu menyimpannya dalam variabel $SecondaryReplica.
Perintah keempat menetapkan URL perutean baca-saja ke replika utama. Kemudian mengatur daftar perutean baca-saja pada replika utama.
Perintah kelima menetapkan URL perutean baca-saja ke replika sekunder.
Perintah keenam mengatur daftar perutean baca-saja pada replika utama. Koneksi yang memiliki dengan string koneksi properti ReadOnly dialihkan ke replika sekunder. Jika replika sekunder tidak dapat dibaca, koneksi diarahkan kembali ke replika utama.
Contoh 5: Mengubah prioritas pencadangan
PS C:\> Set-SqlAvailabilityReplica -BackupPriority 60 -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAG\AvailabilityReplicas\Replica02"
Perintah ini mengatur prioritas cadangan replika ketersediaan 'Replica02' ke 60. Prioritas ini digunakan oleh instans server yang menghosting replika utama untuk memutuskan replika mana yang harus melayani permintaan pencadangan otomatis pada database dalam grup ketersediaan. Replika yang memiliki prioritas tertinggi dipilih.
Parameter
-AvailabilityMode
Menentukan mode ketersediaan replika. Nilai yang dapat diterima untuk parameter ini adalah:
- SynchronousCommit
- AsinkronCommit
Anda dapat menentukan nilai $Null.
Properti parameter
| Jenis: | AvailabilityReplicaAvailabilityMode |
| 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 |
-BackupPriority
Menentukan prioritas replika yang diinginkan dalam melakukan pencadangan. Nilai yang dapat diterima untuk parameter ini adalah: bilangan bulat dari 0 hingga 100. Dari set replika yang online dan tersedia, replika yang memiliki prioritas tertinggi melakukan pencadangan.
Nilai nol (0) menunjukkan bahwa replika bukan kandidat.
Properti parameter
| Jenis: | Int32 |
| 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 |
-ConnectionModeInPrimaryRole
Menentukan bagaimana replika ketersediaan menangani koneksi saat berada dalam peran utama. Nilai yang dapat diterima untuk parameter ini adalah:
- AllowReadWriteConnections. Perbolehkan koneksi baca/tulis.
- AllowAllConnections. Perbolehkan semua koneksi.
Properti parameter
| Jenis: | AvailabilityReplicaConnectionModeInPrimaryRole |
| 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 |
-ConnectionModeInSecondaryRole
Menentukan bagaimana replika ketersediaan menangani koneksi saat berada dalam peran sekunder. Nilai yang dapat diterima untuk parameter ini adalah:
- AllowNoConnections. Larang koneksi.
- AllowReadIntentConnectionsOnly. Izinkan hanya koneksi baca-niat.
- AllowAllConnections. Perbolehkan semua koneksi.
Properti parameter
| Jenis: | AvailabilityReplicaConnectionModeInSecondaryRole |
| 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 |
-EndpointUrl
Menentukan URL titik akhir pencerminan database. URL ini adalah alamat TCP dalam formulir berikut:
TCP://system-address:port
Properti parameter
| Jenis: | String |
| 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 |
-FailoverMode
Menentukan mode failover. Nilai yang dapat diterima untuk parameter ini adalah:
- Otomatis
- Panduan. Anda dapat menentukan nilai $Null.
Properti parameter
| Jenis: | AvailabilityReplicaFailoverMode |
| 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, sebagai objek AvailabilityGroup , tempat replika berada.
Properti parameter
| Jenis: | AvailabilityReplica |
| 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 tempat replika berada. 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 |
-ReadonlyRoutingConnectionUrl
Menentukan nama domain yang sepenuhnya memenuhi syarat (FQDN) dan port yang akan digunakan saat perutean ke replika untuk koneksi baca saja, seperti dalam contoh berikut:
TCP://DBSERVER8.manufacturing.Contoso.com:7024
Properti parameter
| Jenis: | String |
| 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 |
-ReadOnlyRoutingList
Menentukan daftar nama server replika yang diurutkan yang mewakili urutan pemeriksaan untuk digunakan oleh direktur koneksi saat mengalihkan koneksi baca-saja melalui replika ketersediaan ini. Parameter ini berlaku jika replika ketersediaan adalah replika utama grup ketersediaan saat ini.
Properti parameter
| Jenis: | String[] |
| 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 |
-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 |
-SessionTimeout
Menentukan jumlah waktu, dalam detik, untuk menunggu respons antara replika utama dan replika ini sebelum koneksi gagal.
Properti parameter
| Jenis: | Int32 |
| 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.