Поделиться через


sp_syspolicy_rename_policy (Transact-SQL)

Переименовывает существующую политику в управлении на основе политик.

Значок ссылки на разделСинтаксические обозначения в Transact-SQL

Синтаксис

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

Аргументы

  • [ @name= ] 'name'
    Имя политики для переименования. Аргумент name имеет тип sysname, и его обязательно указывать, если аргумент policy_id имеет значение NULL.

  • [ @policy_id= ] policy_id
    Идентификатор политики для переименования. Аргумент policy_id имеет тип int, и его обязательно указывать, если аргумент name имеет значение NULL.

  • [ @new_name= ] 'new_name'
    Новое имя политики. Аргумент new_name имеет тип sysname и является обязательным. Не может быть пустой строкой и не может принимать значение NULL.

Значения кода возврата

0 (успешное завершение) или 1 (неуспешное завершение)

Замечания

Процедура sp_syspolicy_rename_policy должна выполняться в контексте системной базы данных msdb.

Необходимо указать либо значение аргумента name, либо значение аргумента policy_id. Они не могут одновременно иметь значения NULL. Чтобы получить эти значения, запросите системное представление msdb.dbo.syspolicy_policies.

Разрешения

Требуется членство в предопределенной роли базы данных PolicyAdministratorRole.

Примечание по безопасностиПримечание по безопасности

Возможное повышение прав учетных данных. Пользователи с ролью PolicyAdministratorRole могут создавать триггеры сервера и планировать выполнение политик, влияющих на работу экземпляра компонента Database Engine. Например, пользователи в роли PolicyAdministratorRole могут создать политику, которая может запретить создание большинства объектов в компоненте Database Engine. Вследствие возможного повышения прав учетных данных роль PolicyAdministratorRole должна предоставляться только пользователям, имеющим право изменять конфигурацию компонента Database Engine.

Примеры

В следующем примере имя политики «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