通过

  • 项目

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（失败）

注释

您必须在 msdb 系统数据库的上下文中运行 sp_syspolicy_rename_policy_category。

必须为 name 或 policy_category_id 指定一个值。两者不能均为 NULL。若要获取这些值，请查询 msdb.dbo.syspolicy_policy_categories 系统视图。

权限

要求具有 PolicyAdministratorRole 固定数据库角色的成员身份。

安全说明安全说明

可能的凭据提升：具有 PolicyAdministratorRole 角色的用户可以创建服务器触发器并计划策略执行，这可能会影响数据库引擎实例的正常运行。例如，PolicyAdministratorRole 角色中的用户可以创建一个策略，它可能会禁止在数据库引擎中创建大多数对象。由于这种可能的凭据提升，只应将 PolicyAdministratorRole 角色授予可信任其控制数据库引擎配置的用户。

示例

下面的示例将名为“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