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>] Description
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 中的訊息識別碼。
| 類型: | 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 中的屬性識別碼。
| 類型: | 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