sp_syspolicy_rename_policy_category (Transact-SQL)

  • 项目

适用于：SQL Server

在基于策略的管理中重命名现有策略类别。

Transact-SQL 语法约定

语法

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

参数

[ @name = ] N'name'

要重命名的策略类别的名称。 @name 为 sysname，如果 @policy_category_id 为 NULL，则必须指定。

[ @policy_category_id = ] policy_category_id

要重命名的策略类别的标识符。 @policy_category_id 为 int，如果 @name 为 NULL，则必须指定。

[ @new_name = ] N'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

后续步骤