Set-CMStatusFilterRule

修改状态消息的 Configuration Manager 筛选器规则的设置。

语法

Set-CMStatusFilterRule
   [-AllowDeleteAfterDays <Int32>]
   [-ComponentName <String>]
   [-ForwardToStatusSummarizer <Boolean>]
   [-MessageId <Int32>]
   [-MessageType <MessageType>]
   -Name <String>
   [-Priority <PriorityChangeType>]
   [-ProcessLowerPriorityRule <Boolean>]
   [-ProgramPath <String>]
   [-PropertyId <String>]
   [-PropertyValue <String>]
   [-ReplicateToParentSite <Boolean>]
   [-ReplicationPriority <ReplicationPriority>]
   [-ReportToEventLog <Boolean>]
   [-RunProgram <Boolean>]
   [-SeverityType <SeverityType>]
   [-SiteCode <String>]
   [-SiteSystemServerName <String>]
   [-Source <String>]
   [-StatusFilterRuleSiteCode <String>]
   [-WriteToDatabase <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

Set-CMStatusFilterRule cmdlet 修改状态消息的 Configuration Manager 筛选器规则的设置。 Configuration Manager 根据规则按优先级顺序检查状态消息。 规则可以指定优先级较低的规则在应用该规则后不适用于邮件。

状态筛选器规则指定 Configuration Manager 如何响应状态消息。 每个筛选规则都包含状态消息的条件和操作。 可以为每个站点配置状态筛选器规则,而不是跨所有站点配置状态筛选器规则。

若要更改规则的优先级,请使用规则名称指定规则。

注意

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet,例如 PS XYZ:\>。 有关详细信息,请参阅 入门

示例

示例 1:提高规则的优先级

PS XYZ:\> Set-CMStatusFilterRule -Name "Status change to critical" -SiteCode "CM1" -Priority Increase

此命令会增加具有网站代码 CM1 的站点中具有指定名称的筛选器规则的优先级。

参数

-AllowDeleteAfterDays

类型:Int32
别名:AllowUserDeleteMessagesAfterThresholdDays
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ComponentName

指定与状态消息对应的 Configuration Manager 组件。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ForceWildcardHandling

此参数处理通配符,并可能导致意外行为, (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ForwardToStatusSummarizer

指示是否转发到状态摘要生成器。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-MessageId

在 Configuration Manager 中指定消息 ID。

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-MessageType

在 Configuration Manager 中指定状态消息类型。

有效值包含:

  • Audit
  • 详情
  • 里程碑
  • None
类型:MessageType
接受的值:None, Milestone, Detail, Audit
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Name

指定状态筛选规则的名称数组。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:True

-Priority

指定优先级更改。 Configuration Manager 根据规则按规则优先级顺序检查状态消息。 有效值为:减少和增加。

类型:PriorityChangeType
接受的值:Increase, Decrease
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ProcessLowerPriorityRule

指示是否处理优先级较低的规则,这会阻止进一步的规则处理。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ProgramPath

指定在状态消息与状态筛选器规则匹配时运行的程序的路径。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-PropertyId

在 Configuration Manager 中指定属性 ID。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-PropertyValue

指定相应的 PropertyId 参数的值。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ReplicateToParentSite

指示是否将消息传递到父站点。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ReplicationPriority

指定用于将状态消息发送到父站点的复制优先级。

有效值包含:

类型:ReplicationPriority
接受的值:High, Medium, Low
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ReportToEventLog

指示是否在 Windows 事件日志中报告事件。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-RunProgram

指示在状态消息与筛选规则匹配时是否运行程序。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-SeverityType

指定状态消息的严重性。

有效值包含:

  • 错误
  • 信息
  • None
  • 警告
类型:SeverityType
接受的值:None, Informational, Warning, Error
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-SiteCode

指定 Configuration Manager 站点的站点代码。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-SiteSystemServerName

指定 Configuration Manager 中站点系统服务器的名称。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Source

指定要匹配的状态消息源。 可能的来源如下:

  • 客户端
  • SMS 提供程序
  • 站点服务器
类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-StatusFilterRuleSiteCode

指定来自状态消息的站点的站点代码。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-WriteToDatabase

指示是否将消息写入数据库。 为此参数指定值 $True,以启用 AllowUserDeleteMessagesAfterThresholdDays 参数。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

None