Freigeben über

Get-CMComponentStatusMessage

  • Referenz
Modul:
ConfigurationManager

Abrufen von Komponentenstatusmeldungen in Configuration Manager.

Syntax

Get-CMComponentStatusMessage
   [-ComponentName <String>]
   [-ComputerName <String>]
   [-Severity <Severity>]
   [-SiteCode <String>]
   -StartTime <DateTime>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-CMComponentStatusMessage ruft Komponentenstatusmeldungen für einen angegebenen Zeitraum ab.

Configuration Manager gibt an, ob Vorgänge erfolgreich sind oder fehlschlagen, und schließt weitere Informationen in Komponentenstatusmeldungen ein. Threads oder Prozesse senden Komponentenstatusmeldungen an Configuration Manager-Standorte, die durch Standortcodes identifiziert werden.

Sie können definieren, welche Nachrichten nach dem Schweregrad der Nachricht, der Komponente, die die Nachricht erstellt hat, dem Computer, auf dem diese Komponente gehostet wird, oder dem Configuration Manager-Server, der die Nachricht empfängt. Geben Sie immer einen Anzeigezeitraum als TimeSpan-Objekt an.

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: Abrufen von Fehlermeldungen für eine Website

In diesem Beispiel werden alle Meldungen mit dem Fehlerschweregrad einer bestimmten Startzeit abgerufen.

Get-CMComponentStatusMessage -StartTime "2/1/2013 12:00 AM" -Severity Error

Beispiel 2: Abrufen von Warnmeldungen für eine Website innerhalb der letzten 24 Stunden

In diesem Beispiel werden alle Warnungen für eine bestimmte Website am letzten Tag abgerufen.

Get-CMComponentStatusMessage -StartTime $(Get-Date).AddHours(-24) -Severity Warning -SiteCode "CM1"

Beispiel 3: Abrufen einer Zusammenfassung der Nachrichten für alle Komponenten innerhalb der letzten 24 Stunden

In diesem Beispiel wird zunächst das Cmdlet Get-CMSiteComponent verwendet, um eine Liste aller Komponenten von der aktuellen Website abzurufen. Sie leitet diese Liste über mehrere Cmdlets weiter, um die Liste zu formatieren, und durchläuft dann jede Komponente. Für jede Komponente werden die Fehler- und Warnmeldungsstatusmeldungen für den letzten Tag abgerufen. Anschließend wird die Anzahl der Fehler und Warnungen für jede Komponente am letzten Tag zusammengefasst.

Hinweis

Die Ausführung dieses Befehls kann mehrere Minuten dauern.

PS OPC:\> Get-CMSiteComponent | Select-Object -ExpandProperty ComponentName -Unique | Sort-Object ComponentName | ForEach-Object {
    $errs  = $(Get-CMComponentStatusMessage -ComponentName $_ -Severity Error -StartTime $(Get-Date).AddHours(-24)).Count
    $warns = $(Get-CMComponentStatusMessage -ComponentName $_ -Severity Warning -StartTime $(Get-Date).AddHours(-24)).Count
    [pscustomobject]@{
        Component  = $_
        Errors     = $errs
        Warnings   = $warns
    }
}

Component                             Errors Warnings
---------                             ------ --------
SMS_AD_SECURITY_GROUP_DISCOVERY_AGENT    742        0
SMS_WSUS_SYNC_MANAGER                     90        0
SMS_WSUS_CONFIGURATION_MANAGER             0        0
SMS_WSUS_CONTROL_MANAGER                  62        0
SMS_AD_SYSTEM_DISCOVERY_AGENT              0        0
SMS_CLIENT_HEALTH                          0        0
SMS_CLOUD_PROXYCONNECTOR                   0        0
SMS_AD_USER_DISCOVERY_AGENT                0      612
...

Parameter

-ComponentName

Gibt den Namen eines Threads oder Prozesses an. Ein Thread oder Prozess sendet eine Komponentenstatusmeldung.

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

-ComputerName

Legen Sie die Ergebnisse der Statusmeldungen fest, und geben Sie den Namen eines Computers an, der eine Komponente hostet.

Typ:String
Aliase:MachineName
Position:Named
Standardwert:None
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

-Severity

Gibt den Schweregrad der abzurufenden Komponentenstatusmeldungen an.

Hinweis

Dieser Parameter funktioniert derzeit nicht mit dem All Wert, gibt aber auch keine Werte zurück, wenn er weggelassen wird.

Typ:Severity
Zulässige Werte:All, Error, Warning, Information
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SiteCode

Gibt einen Standortcode an, von dem Komponentenstatusmeldungen abgerufen werden sollen.

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

-StartTime

Geben Sie eine Uhrzeit für den Beginn des Anzeigezeitraums für die Komponentenstatusmeldungen an.

Typ:DateTime
Aliase:ViewingPeriod
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

IResultObject[]

IResultObject