sp_syspolicy_set_config_history_retention (Transact-SQL)

指定为基于策略的管理而保留策略评估历史纪录的天数。

主题链接图标Transact-SQL 语法约定

语法

sp_syspolicy_set_config_history_retention [ @value = ] value

参数

  • [ @value= ] value
    要保留基于策略的管理历史纪录的天数。value 的数据类型为 sqlvariant。

返回代码值

0(成功)或 1(失败)

注释

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

如果 value 设置为 0,则不会自动删除历史纪录。

若要查看历史记录保持期的当前值,请运行以下查询:

SELECT current_value FROM msdb.dbo.syspolicy_configuration
WHERE name = 'HistoryRetentionInDays'

权限

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

安全说明安全说明

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

示例

下面的示例将策略评估历史记录保持期设置为 28 天。

EXEC msdb.dbo.sp_syspolicy_set_config_history_retention @value = 28;

GO