sp_syspolicy_rename_policy (T-SQL)

Berlaku untuk:SQL Server

Mengganti nama kebijakan yang ada dalam Manajemen Berbasis Kebijakan.

Konvensi sintaks transact-SQL

Sintaks

sp_syspolicy_rename_policy
    { [ @name = ] N'name' | [ @policy_id = ] policy_id }
    , [ @new_name = ] N'new_name'
[ ; ]

Argumen

[ @name = ] N'name'

Nama kebijakan yang ingin Anda ganti namanya. @name adalah sysname, dan harus ditentukan jika @policy_id NULL.

[ @policy_id = ] policy_id

Pengidentifikasi untuk kebijakan yang ingin Anda ganti namanya. @policy_id int, dan harus ditentukan jika @name NULL.

[ @new_name = ] N'new_name'

Nama baru untuk kebijakan tersebut. @new_name adalah sysname, dan diperlukan. Tidak boleh NULL atau string kosong.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Keterangan

Anda harus menjalankan sp_syspolicy_rename_policy dalam konteks msdb database sistem.

Anda harus menentukan nilai untuk @name atau @policy_id. Keduanya tidak boleh NULL. Untuk mendapatkan nilai-nilai ini, kueri msdb.dbo.syspolicy_policies 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 mengganti nama kebijakan yang diberi nama Test Policy 1 menjadi Test Policy 2.

EXEC msdb.dbo.sp_syspolicy_rename_policy
    @name = N'Test Policy 1',
    @new_name = N'Test Policy 2';
GO