sp_syspolicy_rename_policy (Transact-SQL)
Область применения: SQL Server
Переименовывает существующую политику в управлении на основе политик.
Соглашения о синтаксисе Transact-SQL
Синтаксис
sp_syspolicy_rename_policy
{ [ @name = ] N'name' | [ @policy_id = ] policy_id }
, [ @new_name = ] N'new_name'
[ ; ]
Аргументы
[ @name = ] N'name'
Имя политики, которую нужно переименовать. @name является sysname и должен быть указан, если @policy_id NULL
.
[ @policy_id = ] policy_id
Идентификатор политики, которую требуется переименовать. @policy_id является int и должен быть указан, если @name .NULL
[ @new_name = ] N'new_name'
Новое имя политики. @new_name является sysname и является обязательным. Не может быть NULL
или пустая строка.
Значения кода возврата
0
(успешно) или 1
(сбой).
Замечания
Необходимо выполнить sp_syspolicy_rename_policy
в контексте msdb
системной базы данных.
Необходимо указать значение для @name или @policy_id. Оба не могут быть NULL
. Чтобы получить эти значения, запросите системное msdb.dbo.syspolicy_policies
представление.
Разрешения
Требуется членство в предопределенной роли базы данных PolicyAdministratorRole .
Внимание
Возможное повышение прав учетных данных: пользователи в роли PolicyAdministratorRole могут создавать триггеры сервера и планировать выполнение политик, которые могут повлиять на работу экземпляра ядро СУБД. Например, пользователи роли PolicyAdministratorRole могут создавать политику, которая может препятствовать созданию большинства объектов в ядро СУБД. Из-за этого возможного повышения прав учетных данных роль PolicyAdministratorRole должна предоставляться только пользователям, которым доверено управление конфигурацией ядро СУБД.
Примеры
В следующем примере переименовывается политика с именем Test Policy 1
Test Policy 2
.
EXEC msdb.dbo.sp_syspolicy_rename_policy
@name = N'Test Policy 1',
@new_name = N'Test Policy 2';
GO