WMI-Klasse des SMS_StatusMessage-Servers
Die SMS_StatusMessage WMI-Klasse (Windows Management Instrumentation) ist eine SMS-Anbieter-Serverklasse in Configuration Manager, die einzelne status Nachrichten darstellt, die von Configuration Manager generiert werden, um Informationen zu einer Vielzahl von Ereignissen bereitzustellen, einschließlich Prozessabschluss, Fehler, Bedingungen und Benutzeraktionen.
Die folgende Syntax wird vom MOF-Code (Managed Object Format) vereinfacht und enthält alle geerbten Eigenschaften.
Syntax
Class SMS_StatusMessage : SMS_BaseClass
{
String Component;
String MachineName;
UInt32 MessageID;
UInt32 MessageType;
String ModuleName;
UInt32 PerClient;
UInt32 ProcessID;
SInt64 RecordID;
UInt32 ReportFunction;
UInt32 Severity;
String SiteCode;
UInt32 SuccessfulTransaction;
UInt32 ThreadID;
DateTime Time;
String TopLevelSiteCode;
UInt32 Transaction;
UInt32 Win32Error;
};
Methoden
In der folgenden Tabelle sind die Methoden in SMS_StatusMessageaufgeführt.
| Methode | Beschreibung |
|---|---|
| DeleteByID-Methode in Class SMS_StatusMessage | Löscht eine Gruppe von bis zu 256 status Nachrichten. |
| DeleteByQuery-Methode in class SMS_StatusMessage | Löscht eine Gruppe von status Nachrichten, die von einer SELECT-Anweisung der WMI-Abfragesprache angegeben werden. |
| RaiseErrorStatusMsg-Methode in der Klasse SMS_StatusMessage | Erstellt einen Fehler status Meldung. |
| RaiseInformationalStatusMsg-Methode in der Klasse SMS_StatusMessage | Erstellt eine informationsbasierte status Nachricht. |
| RaiseRawStatusMsg-Methode in der Klasse SMS_StatusMessage | Erstellt eine status Nachricht aus einer externen Nachrichten-DLL. |
| RaiseWarningStatusMsg-Methode in der Klasse SMS_StatusMessage | Erstellt eine Warnung status Meldung. |
Eigenschaften
Component
Datentyp: String
Zugriffstyp: Lesen
Qualifizierer: Keine
Name der Komponente, die die Nachricht erstellt hat. Bei benutzerdefinierten Nachrichten stammt dieser Name aus dem Kontextqualifizierer, den ApplicationName Sie festlegen müssen, bevor Sie eine Raise-status Message-Methode aufrufen.
MachineName
Datentyp: String
Zugriffstyp: Lesen
Qualifizierer: Keine
Name des Computers, der die Nachricht erstellt hat. Bei benutzerdefinierten Nachrichten stammt dieser Name aus dem Kontextqualifizierer, den MachineName Sie festlegen müssen, bevor Sie eine Raise-status Message-Methode aufrufen.
MessageID
Datentyp: UInt32
Zugriffstyp: Lesen
Qualifizierer: [Bereich("0-65535")]
Eindeutige ID des Nachrichtentexts in einer Nachrichten-DLL. Diese Eigenschaft wird auf den zugeordneten Wert festgelegt, wenn Ihre Anwendung eine in der folgenden Tabelle aufgeführte Methode aufruft.
MessageType
Datentyp: UInt32
Zugriffstyp: Lesen
Qualifizierer: Keine
Typ der Nachricht. Die folgenden Werte sind möglich:
| Wert | Nachrichtentyp |
|---|---|
| 256 | Meilenstein. Verwenden Sie diesen Typ am Ende eines Vorgangs, um den Erfolg oder Fehler des Vorgangs anzugeben. Wenn der Vorgang erfolgreich war, verwenden Sie den Meilensteintyp in einer Informationsmeldung. Wenn der Vorgang fehlgeschlagen ist, verwenden Sie einen Meilensteinnachrichtentyp in einer Warnung oder Fehlermeldung. |
| 512 | Detail. Verwenden Sie diesen Typ, um die Schritte in einem komplexen Vorgang zu veranschaulichen. Detailmeldungen sind häufig nur im Kontext der Sequenz von status Nachrichten, die einen komplexen Vorgang darstellen, aussagekräftig. |
| 768 | Rechnungsprüfung. Verwenden Sie diesen Typ für Informationsmeldungen, die eine Spur der Aktionen des Configuration Manager Administrators enthalten. Eine Überwachungsmeldung zeigt auch einen Vorgang, der dazu führt, dass Objekte hinzugefügt, geändert oder gelöscht werden. Sie müssen keine Überwachungsmeldungen erstellen. Der Anbieter generiert diese Nachrichten automatisch für Sie. |
| 1024 | NTEvent. |
ModuleName
Datentyp: String
Zugriffstyp: Lesen
Qualifizierer: Keine
Die DLL, die der status Nachricht zugeordnet ist. Dies ist nicht der Name der DLL selbst, sondern eine Anzeigezeichenfolge, die dem in der ModuleNameSMS_StatMsgModuleNames Server WMI Class-Klasse definierten Eigenschaftswert entspricht. Sie verwenden den ModuleName Wert, um den DLL-Namen abzurufen.
PerClient
Datentyp: UInt32
Zugriffstyp: Lesen
Qualifizierer: Keine
Wert, der angibt, ob die status Nachricht von einer Clientkomponente generiert wurde. Mögliche Werte sind unten aufgeführt. Nachrichten, die pro Client generiert werden, sind in der Regel recht zahlreich. Daher bietet diese Eigenschaft eine einfache Möglichkeit, sie herauszufiltern.
| Wert | Pro Client generierte Nachricht |
|---|---|
| 0 | false |
| 2 | true |
ProcessID
Datentyp: UInt32
Zugriffstyp: Lesen
Qualifizierer: Keine
ID des Prozesses, der die Nachricht erstellt hat.
RecordID
Datentyp: SInt64
Zugriffstyp: Lesen
Qualifizierer: [Schlüssel]
Eindeutige ID der status Nachricht.
ReportFunction
Datentyp: UInt32
Zugriffstyp: Lesen
Qualifizierer: Keine
Berichtsfunktion. Die folgenden Werte sind möglich:
| Wert | Berichtsfunktion |
|---|---|
| 0 | Bericht |
| 16 | BeginTransaction |
| 32 | CommitSuccessfulTransaction |
| 48 | CommitFailedTransaction |
| 64 | RollbackTransaction |
| 80 | ReportEX |
Severity
Datentyp: UInt32
Zugriffstyp: Lesen
Qualifizierer: Keine
Schweregrad der status Nachricht. Die folgenden Werte sind möglich:
| Wert | Severity |
|---|---|
| 0x40000000 (1073741824) | Zur Information |
| 0x80000000 (2147483648) | Warnung |
| 0xC0000000 (3221225472) |
Error |
SiteCode
Datentyp: String
Zugriffstyp: Lesen
Qualifizierer: [SizeLimit("3")]
Standortcode der Website, die die Nachricht erstellt hat.
SuccessfulTransaction
Datentyp: UInt32
Zugriffstyp: Lesen
Qualifizierer: Keine
Wert, der die transaktion status angibt. Die folgenden Werte sind möglich:
| Wert | Transaktions-status |
|---|---|
| 0 | Fehlgeschlagen |
| 8 | Erfolgreich |
ThreadID
Datentyp: UInt32
Zugriffstyp: Lesen
Qualifizierer: Keine
Bezeichner des Threads, der die Nachricht erstellt hat.
Time
Datentyp: DateTime
Zugriffstyp: Lesen
Qualifizierer: Keine
Datum und Uhrzeit in koordinierter Weltzeit (UTC), wann die status Nachricht erstellt wurde.
TopLevelSiteCode
Datentyp: String
Zugriffstyp: Lesen
Qualifizierer: [SizeLimit("3")]
Diese Eigenschaft ist veraltet.
Transaction
Datentyp: UInt32
Zugriffstyp: Lesen
Qualifizierer: Keine
Wert, der angibt, ob Transaktionen aktiviert sind. Die folgenden Werte sind möglich:
| Wert | Transaktion aktiviert |
|---|---|
| 0 | Falsch |
| 4 | Wahr |
Win32Error
Datentyp: UInt32
Zugriffstyp: Lesen
Qualifizierer: Keine
Win32-Fehlercode, der der status Meldung zugeordnet ist.
Hinweise
Klassenqualifizierer für diese Klasse sind:
Lesen (schreibgeschützt)
Gesichert
Weitere Informationen sowohl zu den Klassenqualifizierern als auch zu den Eigenschaftenqualifizierern, die im Abschnitt Eigenschaften enthalten sind, finden Sie unter Configuration Manager Klassen- und Eigenschaftsqualifizierer.
Mit dieser Klasse können Sie benutzerdefinierte status-Nachrichten generieren.
Hinweis
Verwenden Sie die SMS_StatMsg Server-WMI-Klasse für eine hochleistungsfähige Version dieser Klasse.
Anforderungen
Laufzeitanforderungen
Weitere Informationen finden Sie unter anforderungen an Configuration Manager Server Runtime.
Entwicklungsanforderungen
Weitere Informationen finden Sie unter Configuration Manager Serverentwicklungsanforderungen.