New-CMStatusFilterRule

Erstellt eine Regel in 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>]

Beschreibung

Das Cmdlet "New-CMStatusFilterRule" erstellt eine Regel, die eine oder mehrere Aktionen auslöst, die einen Administrator mit einer bestimmten Nachricht in Configuration Manager warnen.

Hinweis

Führen Sie Configuration Manager-Cmdlets beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\> aus. Weitere Informationen finden Sie unter "Erste Schritte".

Beispiele

Beispiel 1: Erstellen einer Statusfilterregel

Dieser Befehl erstellt eine Statusfilterregel an der XYZ-Website, um die Statusmeldung 4611 zu erkennen und ein Ereignis in das Windows Protokoll zu schreiben.

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

Parameter

-AllowDeleteAfterDays

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

-ComponentName

Gibt die Configuration Manager-Komponente an, die den Statusmeldungen entspricht.

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

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

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

-DisableWildcardHandling

Dieser Parameter behandelt Platzhalterzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandlingkombinieren.

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

-ForceWildcardHandling

Dieser Parameter verarbeitet Platzhalterzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandlingkombinieren.

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

-ForwardToStatusSummarizer

Gibt an, ob an den Status-Summarizer weitergeleitet werden soll.

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

-MessageId

Gibt eine Nachrichten-ID in Configuration Manager an.

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

-MessageType

Gibt einen Statusnachrichtentyp in Configuration Manager an.

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

-Name

Gibt einen Namen für die Statusfilterregel an.

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

-ProcessLowerPriorityRule

Gibt an, ob eine Regel mit niedrigerEr Priorität verarbeitet werden soll, wodurch eine weitere Regelverarbeitung verhindert wird.

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

-ProgramPath

Gibt einen Pfad zu einem Programm an, das ausgeführt wird, wenn eine Statusmeldung mit der Statusfilterregel übereinstimmt.

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

-PropertyId

Gibt eine Eigenschafts-ID in Configuration Manager an.

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

-PropertyValue

Gibt einen Wert für den entsprechenden PropertyId-Parameter an.

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

-ReplicateToParentSite

Gibt an, ob eine Nachricht an die übergeordnete Website übergeben werden soll.

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

-ReplicationPriority

Gibt eine Replikationspriorität zum Senden von Statusmeldungen an den übergeordneten Standort an. Die zulässigen Werte für diesen Parameter sind: Hoch, Niedrig und Mittel.

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

-ReportToEventLog

Gibt an, ob ein Ereignis im Windows Ereignisprotokoll gemeldet werden soll.

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

-RunProgram

Gibt an, ob ein Programm ausgeführt werden soll, wenn eine Statusmeldung mit einer Filterregel übereinstimmt.

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

-SeverityType

Gibt den Schweregrad einer Statusmeldung an.

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

-SiteCode

Gibt einen Configuration Manager-Standortcode an, der die Statusregel definiert.

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

-SiteSystemServerName

Gibt einen Namen des Standortsystemservers an.

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

-Source

Gibt die zuzuordnende Statusmeldungsquelle an.

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

-StatusFilterRuleSiteCode

Gibt einen Websitecode für die Statusfilterregel an.

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

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

-WriteToDatabase

Gibt an, ob eine Nachricht in die Datenbank geschrieben werden soll. Muss festgelegt sein, um den Parameter AllowUserDeleteMessagesAfterThresholdDays zu aktivieren.

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

Eingaben

Keine

Ausgaben

IResultObject