New-CMStatusFilterRule

模块:

ConfigurationManager

在 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

Type:	Int32
Aliases:	AllowUserDeleteMessagesAfterThresholdDays
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ComponentName

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ForwardToStatusSummarizer

指示是否转发到状态汇总器。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MessageId

在 Configuration Manager 中指定邮件 ID。

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MessageType

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

Type:	MessageType
Accepted values:	None, Milestone, Detail, Audit
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ProcessLowerPriorityRule

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

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ProgramPath

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PropertyId

在 Configuration Manager 中指定属性 ID。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PropertyValue

为相应的 PropertyId 参数指定值。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ReplicateToParentSite

指示是否将邮件传递到父网站。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ReplicationPriority

指定向父站点发送状态消息的复制优先级。 此参数的可接受值为：High、Low 和 Medium。

Type:	ReplicationPriority
Accepted values:	Low, Medium, High
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ReportToEventLog

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

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RunProgram

指示当状态邮件与筛选规则匹配时是否运行程序。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SeverityType

指定状态邮件的严重性。

Type:	SeverityType
Accepted values:	None, Informational, Warning, Error
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SiteCode

指定用于定义状态规则的 Configuration Manager 站点代码。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SiteSystemServerName

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Source

指定要匹配的状态消息源。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-StatusFilterRuleSiteCode

指定状态筛选器规则的网站代码。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WriteToDatabase

指示是否将邮件写入数据库。 必须设置为启用 AllowUserDeleteMessagesAfterThresholdDays 参数。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-名称

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

输入

无

输出

IResultObject

相关链接

• Disable-CMStatusFilterRule
• Enable-CMStatusFilterRule
• Get-CMStatusFilterRule
• Remove-CMStatusFilterRule
• Set-CMStatusFilterRule