New-CMStatusFilterRule

New-CMStatusFilterRule

Creates a rule in Configuration Manager.

構文

Parameter Set: Default
New-CMStatusFilterRule -Name <String> -SiteCode <String> [-AllowUserDeleteMessagesAfterThresholdDays <Int32> ] [-ComponentName <String> ] [-ForwardToStatusSummarizer <Boolean> ] [-MessageId <String> ] [-MessageType <MessageType> {Audit | Detail | Milestone | None} ] [-ProcessLowerPriorityRule <Boolean> ] [-ProgramPath <String> ] [-PropertyId <String> ] [-PropertyValue <String> ] [-ReplicateToParentSite <Boolean> ] [-ReplicationPriority <ReplicationPriority> {High | Low | Medium} ] [-ReportToEventLog <Boolean> ] [-RunProgram <Boolean> ] [-SeverityType <SeverityType> {Error | Informational | None | Warning} ] [-SiteSystemServerName <String> ] [-Source <String> ] [-StatusFilterRuleSiteCode <String> ] [-WriteToDatabase <Boolean> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細説明

The New-CMStatusFilterRule cmdlet creates a rule that triggers one or more actions that alerts an administrator to a specific message in Microsoft System Center 2012 Configuration Manager.

パラメーター

-AllowUserDeleteMessagesAfterThresholdDays<Int32>

Specifies how long, in days, to retain messages. Set the WriteToDatabase parameter to enable this setting.

-ComponentName<String>

Specifies the Configuration Manager component that corresponds to the status messages.

-ForwardToStatusSummarizer<Boolean>

Indicates whether to forward to the status summarizer.

-MessageId<String>

Specifies a message ID in Configuration Manager.

-MessageType<MessageType>

Specifies a status message type in Configuration Manager. Valid values are: Audit, Detail, Milestone, and None.

-Name<String>

Specifies a name for the status filter rule.

-ProcessLowerPriorityRule<Boolean>

Indicates whether to process a lower priority rule, which prevents further rule processing.

-ProgramPath<String>

Specifies a path to a program that runs when a status message matches the status filter rule.

-PropertyId<String>

Specifies a property ID in Configuration Manager.

-PropertyValue<String>

Specifies a value for the corresponding PropertyId parameter.

-ReplicateToParentSite<Boolean>

Indicates whether to pass a message to the parent site.

-ReplicationPriority<ReplicationPriority>

Specifies a replication priority for sending status messages to the parent site. Valid values are: High, Low, and Medium.

-ReportToEventLog<Boolean>

Indicates whether to report an event in the Windows event log.

-RunProgram<Boolean>

Indicates whether to run a program when a status message matches a filter rule.

-SeverityType<SeverityType>

Specifies the severity of a status message. Valid values are: Error, Informational, None, and Warning.

-SiteCode<String>

Specifies a System Center 2012 Configuration Manager site code that defines the status rule.

-SiteSystemServerName<String>

Specifies a name of the site system server.

-Source<String>

Specifies the status message source to match.

-StatusFilterRuleSiteCode<String>

Specifies a site code for the status filter rule.

-WriteToDatabase<Boolean>

Indicates whether to write a message to the database. Must be set to enable the AllowUserDeleteMessagesAfterThresholdDays parameter.

-Confirm

コマンドレットを実行する前に、ユーザーに確認を求めます。

-WhatIf

コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

例

Example 1: Create a new status filter rule

This command creates a new status filter rule.

PS C:\> New-CMStatusFilterRule -SiteCode "Contoso2" -Name "11211" -TargetSiteCode "Contoso2" -Source "SMS Provider" -System "Contoso-test" -Component "1111" -MessageType Milestone -SeverityType Informational -MessageId "1234" -PropertyName "403" -PropertyValue "123" -WriteToDatabase $True -AllowDeleteMessagesTimeDays 20 -ReportToEventLog $False -ReplicateToParentSite $False -RunProgram $False -ForwardToStatusSummarizers $True -ProcessLowerPriorityRules $True

関連トピック

Disable-CMStatusFilterRule

Enable-CMStatusFilterRule

Get-CMStatusFilterRule

Remove-CMStatusFilterRule

Set-CMStatusFilterRule