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


sp_syspolicy_rename_policy_category (Transact-SQL)

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

Применимо для следующих объектов: SQL Server (начиная с SQL Server 2008 до текущей версии).

Значок ссылки на раздел Cинтаксические обозначения в 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

См. также

Справочник

Хранимые процедуры управления на основе политик (Transact-SQL)

sp_syspolicy_add_policy_category (Transact-SQL)

sp_syspolicy_delete_policy_category (Transact-SQL)

sp_syspolicy_update_policy_category (Transact-SQL)