Freigeben über


Set-CMStatusFilterRule

Ändert Einstellungen für eine Configuration Manager-Filterregel für Statusmeldungen.

Syntax

Set-CMStatusFilterRule
   [-AllowDeleteAfterDays <Int32>]
   [-ComponentName <String>]
   [-ForwardToStatusSummarizer <Boolean>]
   [-MessageId <Int32>]
   [-MessageType <MessageType>]
   -Name <String>
   [-Priority <PriorityChangeType>]
   [-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 Set-CMStatusFilterRule ändert Einstellungen für eine Configuration Manager-Filterregel für Statusmeldungen. Configuration Manager überprüft eine Statusmeldung anhand von Regeln in der Reihenfolge der Priorität. Eine Regel kann angeben, dass Regeln mit niedrigerer Priorität nicht auf eine Nachricht angewendet werden, nachdem diese Regel angewendet wurde.

Statusfilterregeln geben an, wie Configuration Manager auf Statusmeldungen reagiert. Jede Filterregel enthält Kriterien und Aktionen für Statusmeldungen. Sie konfigurieren Statusfilterregeln für jeden Standort, nicht für alle Standorte.

Um die Priorität einer Regel zu ändern, verwenden Sie den Regelnamen, um die Regel anzugeben.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Erhöhen der Priorität einer Regel

PS XYZ:\> Set-CMStatusFilterRule -Name "Status change to critical" -SiteCode "CM1" -Priority Increase

Dieser Befehl erhöht die Priorität einer Filterregel, die über den angegebenen Namen in einer Website mit dem Standortcode CM1 verfügt.

Parameter

-AllowDeleteAfterDays

Typ:Int32
Aliase:AllowUserDeleteMessagesAfterThresholdDays
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ComponentName

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

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

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForwardToStatusSummarizer

Gibt an, ob an den Statuszusammenfasser weitergeleitet werden soll.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MessageId

Gibt eine Nachrichten-ID in Configuration Manager an.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MessageType

Gibt einen Statusmeldungstyp in Configuration Manager an.

Gültige Werte sind:

  • Überwachung
  • Detail
  • Milestone
  • Keine
Typ:MessageType
Zulässige Werte:None, Milestone, Detail, Audit
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt ein Array von Namen für Statusfilterregeln an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-Priority

Gibt eine Änderung der Priorität an. Configuration Manager überprüft Statusmeldungen anhand von Regeln in der Reihenfolge der Regelpriorität. Gültige Werte sind: Verringern und Erhöhen.

Typ:PriorityChangeType
Zulässige Werte:Increase, Decrease
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ProcessLowerPriorityRule

Gibt an, ob eine Regel mit niedrigerer Priorität verarbeitet werden soll, die eine weitere Regelverarbeitung verhindert.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ProgramPath

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PropertyId

Gibt eine Eigenschafts-ID in Configuration Manager an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PropertyValue

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ReplicateToParentSite

Gibt an, ob eine Nachricht an den übergeordneten Standort übergeben werden soll.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ReplicationPriority

Gibt eine Replikationspriorität für das Senden von Statusmeldungen an den übergeordneten Standort an.

Gültige Werte sind:

  • Hoch
  • Niedrig
  • Mittel
Typ:ReplicationPriority
Zulässige Werte:High, Medium, Low
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ReportToEventLog

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

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RunProgram

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

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SeverityType

Gibt den Schweregrad einer Statusmeldung an.

Gültige Werte sind:

  • Error
  • Zur Information
  • Keine
  • Warnung
Typ:SeverityType
Zulässige Werte:None, Informational, Warning, Error
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SiteCode

Gibt den Standortcode für einen Configuration Manager-Standort an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SiteSystemServerName

Gibt den Namen eines Standortsystemservers in Configuration Manager an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Source

Gibt die zu zuordnende Statusmeldungsquelle an. Mögliche Quellen sind die folgenden:

  • Client
  • SMS-Anbieter
  • Standortserver
Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-StatusFilterRuleSiteCode

Gibt einen Standortcode für die Website an, von der die Statusmeldung stammt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WriteToDatabase

Gibt an, ob eine Nachricht in die Datenbank geschrieben werden soll. Geben Sie den Wert $True für diesen Parameter an, um den Parameter AllowUserDeleteMessagesAfterThresholdDays zu aktivieren.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None