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


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

См. также

Справочник

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