Share via

  • Статья

sp_syspolicy_rename_policy_category (Transact-SQL)

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

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

Синтаксис

sp_syspolicy_rename_policy_category { [ @name = ] 'name' | [ @policy_category_id = ] policy_category_id }
        , [ @new_name = ] 'new_name'

Аргументы

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

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

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

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

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

Замечания

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

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

Разрешения

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

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

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

Примеры

В следующем примере показано переименование категории политики «Test Category 1» в «Test Category 2».

EXEC msdb.dbo.sp_syspolicy_rename_policy_category @name = N'Test Category 1'
, @new_name = N'Test Category 2';

GO