New-CMStatusFilterRule
在 Configuration Manager 中创建规则。
语法
New-CMStatusFilterRule
[-AllowDeleteAfterDays <Int32>]
[-ComponentName <String>]
[-ForwardToStatusSummarizer <Boolean>]
[-MessageId <Int32>]
[-MessageType <MessageType>]
-Name <String>
[-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>] 说明
New-CMStatusFilterRule cmdlet 创建一个规则，该规则触发一个或多个操作，提醒管理员在 Configuration Manager 中收到特定消息。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。
示例
示例 1：创建状态筛选器规则
此命令在 XYZ 站点上创建状态筛选器规则，以检测状态消息 4611 并在 Windows 日志中写入事件。
New-CMStatusFilterRule -SiteCode "XYZ" -Name "Detect when the component status summarizer resets the status of a component." -Source "Site Server" -ComponentName "SMS_COMPONENT_STATUS_SUMMARIZER" -MessageId "4611" -ReportToEventLog $True -ReplicateToParentSite $False -RunProgram $False -ForwardToStatusSummarizer $True -ProcessLowerPriorityRule $True参数
-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 中指定状态消息类型。
| 类型: | MessageType |
| 接受的值: | None, Milestone, Detail, Audit |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Name
指定状态筛选器规则的名称。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | 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
指定用于将状态消息发送到父站点的复制优先级。 此参数的可接受值为：High、Low 和 Medium。
| 类型: | ReplicationPriority |
| 接受的值: | Low, Medium, High |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ReportToEventLog
指示是否在 Windows 事件日志中报告事件。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-RunProgram
指示在状态消息与筛选规则匹配时是否运行程序。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SeverityType
指定状态消息的严重性。
| 类型: | SeverityType |
| 接受的值: | None, Informational, Warning, Error |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SiteCode
指定用于定义状态规则的 Configuration Manager 站点代码。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SiteSystemServerName
指定站点系统服务器的名称。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Source
指定要匹配的状态消息源。
| 类型: | 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
指示是否将消息写入数据库。 必须设置为启用 AllowUserDeleteMessagesAfterThresholdDays 参数。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
None
输出
IResultObject