New-CMStatusFilterRule

模組:

ConfigurationManager

在 Configuration Manager 中建立規則。

Syntax

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>]

Description

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 中指定郵件識別碼。

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

-MessageType

在 [設定管理員] 中指定狀態郵件類型。

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 中指定屬性識別碼。

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

指定傳送狀態郵件至上層網站的複寫優先順序。 此參數可接受的值為：高、低和中。

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

-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

-名稱

指定狀態篩選規則的名稱。

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

輸入

無

輸出

IResultObject

相關連結

• 停用 CMStatusFilterRule
• Enable-CMStatusFilterRule
• CMStatusFilterRule
• Remove-CMStatusFilterRule
• CMStatusFilterRule