sp_syspolicy_configure (T-SQL)

  • Artikel

Berlaku untuk:SQL Server

Mengonfigurasi pengaturan untuk Manajemen Berbasis Kebijakan, seperti apakah Manajemen Berbasis Kebijakan diaktifkan.

Konvensi sintaks transact-SQL

Sintaks

sp_syspolicy_configure
    [ @name = ] N'name'
    , [ @value = ] value
[ ; ]

Argumen

[ @name = ] N'name'

Nama pengaturan yang ingin Anda konfigurasi. @name adalah sysname, diperlukan, dan tidak boleh NULL atau string kosong.

@name bisa menjadi salah satu nilai berikut:

  • Enabled - Menentukan apakah Manajemen Berbasis Kebijakan diaktifkan.

  • HistoryRetentionInDays - Menentukan jumlah hari riwayat evaluasi kebijakan harus dipertahankan. Jika diatur ke 0, riwayat tidak dihapus secara otomatis.

  • LogOnSuccess - Menentukan apakah Manajemen Berbasis Kebijakan mencatat evaluasi kebijakan yang berhasil.

[ @value = ] nilai

Nilai yang terkait dengan nilai yang ditentukan untuk @name. @value sql_variant, dan diperlukan.

  • Jika Anda menentukan 'Diaktifkan' untuk @name, Anda bisa menggunakan salah satu nilai berikut:

    • 0 - Menonaktifkan Manajemen Berbasis Kebijakan.
    • 1 - Mengaktifkan Manajemen Berbasis Kebijakan.

  • Jika Anda menentukan HistoryRententionInDays untuk @name, tentukan jumlah hari sebagai nilai bilangan bulat.

  • Jika Anda menentukan LogOnSuccess untuk @name, Anda bisa menggunakan salah satu nilai berikut:

    • 0 - Hanya log evaluasi kebijakan yang gagal.
    • 1 - Mencatat evaluasi kebijakan yang berhasil dan gagal.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Keterangan

Anda harus menjalankan sp_syspolicy_configure dalam konteks msdb database sistem.

Untuk menampilkan nilai saat ini untuk pengaturan ini, kueri msdb.dbo.syspolicy_configuration tampilan sistem.

Izin

Memerlukan keanggotaan dalam peran database tetap PolicyAdministratorRole .

Penting

Kemungkinan elevasi kredensial: Pengguna dalam peran PolicyAdministratorRole dapat membuat pemicu server dan menjadwalkan eksekusi kebijakan yang dapat memengaruhi pengoperasian instans Mesin Database. Misalnya, pengguna dalam peran PolicyAdministratorRole dapat membuat kebijakan yang dapat mencegah sebagian besar objek dibuat di Mesin Database. Karena kemungkinan peningkatan kredensial ini, peran PolicyAdministratorRole harus diberikan hanya kepada pengguna yang tepercaya dengan mengontrol konfigurasi Mesin Database.

Contoh

Contoh berikut mengaktifkan Manajemen Berbasis Kebijakan.

EXEC msdb.dbo.sp_syspolicy_configure
    @name = N'Enabled',
    @value = 1;
GO

Contoh berikut menetapkan retensi riwayat kebijakan menjadi 14 hari.

EXEC msdb.dbo.sp_syspolicy_configure
    @name = N'HistoryRetentionInDays',
    @value = 14;
GO

Contoh berikut mengonfigurasi Manajemen Berbasis Kebijakan untuk mencatat evaluasi kebijakan yang berhasil dan gagal.

EXEC msdb.dbo.sp_syspolicy_configure
    @name = N'LogOnSuccess',
    @value = 1;
GO

Konten terkait