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

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