Bagikan melalui

Set-SqlAvailabilityGroup

Modul:
SQLPS Module

Mengatur pengaturan pada grup ketersediaan.

Sintaks

ByPath (Default) 

Set-SqlAvailabilityGroup
    [[-Path] <String>]
    [-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
    [-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
    [-HealthCheckTimeout <Int32>]
    [-DatabaseHealthTrigger <Boolean>]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByObject 

Set-SqlAvailabilityGroup
    [-InputObject] <AvailabilityGroup>
    [-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
    [-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
    [-HealthCheckTimeout <Int32>]
    [-DatabaseHealthTrigger <Boolean>]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Deskripsi

Cmdlet Set-SqlAvailabilityGroup memodifikasi pengaturan pada grup ketersediaan yang ada di Grup Ketersediaan AlwaysOn. Anda dapat mengubah preferensi pencadangan otomatis, tingkat kondisi kegagalan, dan batas waktu pemeriksaan kesehatan. Anda harus menjalankan cmdlet ini pada instans server yang menghosting replika utama.

Contoh

Contoh 1: Mengubah periode batas waktu pemeriksaan kesehatan

PS C:\> Set-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MAinAG" -HealthCheckTimeout 120000

Perintah ini mengubah properti batas waktu pemeriksaan kesehatan pada grup ketersediaan bernama MainAG menjadi 120.000 milidetik, atau dua menit. Jika failover otomatis diaktifkan, setelah durasi waktu ini, Grup Ketersediaan AlwaysOn memulai failover otomatis akan dimulai.

Contoh 2: Ubah preferensi pencadangan otomatis

PS C:\> Set-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG" -AutomatedBackupPreference SecondaryOnly

Perintah ini mengubah preferensi pencadangan otomatis pada grup ketersediaan bernama MainAG menjadi SecondaryOnly. Pencadangan otomatis database dalam grup ketersediaan ini tidak terjadi pada replika utama. Sebaliknya, pencadangan otomatis terjadi pada replika sekunder yang memiliki prioritas cadangan tertinggi.

Contoh 3: Mengubah tingkat kondisi kegagalan

PS C:\> Set-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG" -FailureConditionLevel OnServerDown

Perintah ini mengubah tingkat kondisi kegagalan pada grup ketersediaan bernama MainAG menjadi OnServerDown. Jika instans server yang menghosting replika utama offline dan jika failover otomatis diaktifkan, Grup Ketersediaan AlwaysOn memulai failover otomatis.

Parameter

-AutomatedBackupPreference

Menentukan preferensi pencadangan otomatis untuk grup ketersediaan. Nilai yang dapat diterima untuk parameter ini adalah:

  • Utama. Menentukan bahwa cadangan selalu terjadi pada replika utama. Opsi ini mendukung penggunaan fitur yang tidak tersedia saat pencadangan berjalan pada replika sekunder, seperti cadangan diferensial.
  • SecondaryOnly. Menentukan bahwa cadangan tidak pernah dilakukan pada replika utama. Jika replika utama adalah satu-satunya replika online, pencadangan tidak terjadi.
  • Sekunder. Menentukan bahwa pencadangan terjadi pada replika sekunder, kecuali replika utama adalah satu-satunya replika online. Kemudian pencadangan terjadi pada replika utama.
  • Tidak ada. Menentukan bahwa status primer atau sekunder tidak diperhitungkan saat memutuskan replika mana yang melakukan pencadangan. Sebagai gantinya, prioritas pencadangan dan status online menentukan replika mana yang melakukan pencadangan.

Properti parameter

Jenis:AvailabilityGroupAutomatedBackupPreference
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

-DatabaseHealthTrigger

Cmdlet Set-SqlAvailabilityGroup memodifikasi pengaturan pada grup ketersediaan yang ada di Grup Ketersediaan AlwaysOn. Anda dapat mengubah preferensi pencadangan otomatis, tingkat kondisi kegagalan, dan batas waktu pemeriksaan kesehatan. Anda harus menjalankan cmdlet ini pada instans server yang menghosting replika utama.

Properti parameter

Jenis:Boolean
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

-FailureConditionLevel

Menentukan perilaku failover otomatis dari grup ketersediaan. Nilai yang dapat diterima untuk parameter ini adalah:

  • OnServerDown. Failover atau mulai ulang jika layanan SQL Server berhenti.
  • OnServerUnresponsive. Failover atau mulai ulang jika ada kondisi nilai yang lebih rendah terpenuhi, ditambah ketika layanan SQL Server terhubung ke kluster dan ambang batas HealthCheckTimeout terlampaui, atau jika replika ketersediaan yang saat ini berada dalam peran utama dalam status gagal.
  • OnCriticalServerError. Failover atau mulai ulang jika ada kondisi nilai yang lebih rendah terpenuhi, ditambah ketika kesalahan server penting internal terjadi, yang mencakup kondisi memori, pelanggaran akses tulis yang serius, atau terlalu banyak pembuangan.
  • OnModerateServerError. Failover atau mulai ulang jika ada kondisi nilai yang lebih rendah terpenuhi, ditambah jika terjadi kesalahan Server sedang, wich menyertakan kondisi memori yang persisten.
  • OnAnyQualifiedFailureConditions. Failover atau mulai ulang jika ada kondisi nilai yang lebih rendah terpenuhi, ditambah jika kondisi kegagalan yang memenuhi syarat terjadi, yang mencakup kelelahan utas pekerja mesin dan kebuntuan yang tidak terselesaikan terdeteksi.

Properti parameter

Jenis:AvailabilityGroupFailureConditionLevel
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

-HealthCheckTimeout

Menentukan lamanya waktu, dalam milidetik, setelah itu Grup Ketersediaan AlwaysOn menyatakan server yang tidak responsif tidak sehat.

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

-InputObject

Menentukan grup ketersediaan, sebagai objek AvailabilityGroup , yang dimodifikasi 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 database ketersediaan yang dimodifikasi cmdlet. 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.