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


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