Win32_SystemDriver-Klasse

  • Artikel

Die Win32_SystemDriverWMI-Klasse stellt den Systemtreiber für einen Basisdienst dar.

Die folgende Syntax wurde aus MOF-Code (Managed Object Format, verwaltetes Objektformat) vereinfacht und enthält alle geerbten Eigenschaften. Eigenschaften und Methoden sind in alphabetischer Reihenfolge und nicht in MOF-Reihenfolge angeordnet.

Syntax

[Dynamic, Provider("CIMWin32"), SupportsUpdate, UUID("{8502C4C5-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_SystemDriver : Win32_BaseService
{
  boolean  AcceptPause;
  boolean  AcceptStop;
  string   Caption;
  string   CreationClassName;
  string   Description;
  boolean  DesktopInteract;
  string   DisplayName;
  string   ErrorControl;
  uint32   ExitCode;
  datetime InstallDate;
  string   Name;
  string   PathName;
  uint32   ServiceSpecificExitCode;
  string   ServiceType;
  boolean  Started;
  string   StartMode;
  string   StartName;
  string   State;
  string   Status;
  string   SystemCreationClassName;
  string   SystemName;
  uint32   TagId;
};

Member

Die Win32_SystemDriver-Klasse verfügt über folgende Membertypen:

Methoden

Die Win32_SystemDriver-Klasse verfügt über diese Methoden.

Methode BESCHREIBUNG
Veränderung Klassenmethode, die einen Dienst ändert.
ChangeStartMode Klassenmethode, die den Startmodus eines Diensts ändert.
Erstellen Klassenmethode, die einen neuen Dienst erstellt.
Löschen Klassenmethode, die einen vorhandenen Dienst löscht.
InterrogateService Klassenmethode, die anfordert, dass der Dienst seinen Status auf den Dienst-Manager aktualisiert.
PauseService Klassenmethode, die versucht, den Dienst in den angehaltenen Zustand zu versetzen.
ResumeService Klassenmethode, die versucht, den Dienst in den fortgesetzten Zustand zu versetzen.
Startservice Klassenmethode, die versucht, den Dienst in den Startzustand zu versetzen.
StopService Klassenmethode, die den Dienst im beendeten Zustand versetzt.
UserControlService Klassenmethode, die versucht, einen benutzerdefinierten Steuerelementcode an einen Dienst zu senden.

 

Eigenschaften

Die Win32_SystemDriver-Klasse verfügt über diese Eigenschaften.

AcceptPause

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Dienststrukturen| SERVICE_STATUS|dwControlsAccepted| SERVICE_ACCEPT_PAUSE_CONTINUE"), DisplayName ("Dienst akzeptiert Pause")

Der Dienst kann angehalten werden.

Diese Eigenschaft wird von Win32_BaseService geerbt.

AcceptStop

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Dienststrukturen| SERVICE_STATUS|dwControlsAccepted| SERVICE_ACCEPT_STOP"), DisplayName ("Service akzeptiert Stop")

Der Dienst kann beendet werden.

Diese Eigenschaft wird von Win32_BaseService geerbt.

Caption

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen (64), DisplayName ("Caption")

Kurze Beschreibung des Objekts.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

CreationClassName

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: CIM_Key, DisplayName ("Klassenname")

Name der ersten konkreten Klasse, die in der Vererbungskette angezeigt wird, die bei der Erstellung eines instance verwendet wird. Bei Verwendung mit den anderen Schlüsseleigenschaften der -Klasse ermöglicht diese Eigenschaft die eindeutige Identifizierung aller Instanzen dieser Klasse und ihrer Unterklassen.

Diese Eigenschaft wird von CIM_Service geerbt.

Beschreibung

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Description")

Eine Beschreibung des Objekts.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

DesktopInteract

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Dienststrukturen| QUERY_SERVICE_CONFIG|dwServiceType| SERVICE_INTERACTIVE_PROCESS"), DisplayName ("Interagiert mit Desktop")

Dieser Dienst kann Fenster auf dem Desktop erstellen oder mit ihnen kommunizieren.

Diese Eigenschaft wird von Win32_BaseService geerbt.

DisplayName

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Dienststrukturen| QUERY_SERVICE_CONFIG|lpDisplayName"), DisplayName ("Anzeigename")

Anzeigename des Diensts. Die maximale Länge der Zeichenfolge beträgt 256 Zeichen. Der Name wird im Dienststeuerungs-Manager in Groß- und Kleinschreibung beibehalten. Bei DisplayName-Vergleichen wird immer zwischen Groß-/Kleinschreibung unterschieden.

Einschränkungen: Akzeptiert denselben Wert wie die Name-Eigenschaft .

Beispiel: "Atdisk"

Diese Eigenschaft wird von Win32_BaseService geerbt.

ErrorControl

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Dienststrukturen| QUERY_SERVICE_CONFIG|dwErrorControl"), DisplayName ("Schweregrad des Startfehlers")

Schweregrad des Fehlers, wenn dieser Dienst während des Starts nicht gestartet werden kann. Dieser Wert gibt die Aktion an, die vom Startprogramm ausgeführt wird, wenn ein Fehler auftritt. Alle Fehler werden vom Computersystem protokolliert.

Diese Eigenschaft wird von Win32_BaseService geerbt.

Ignore ("Ignore")

Der Benutzer wird nicht benachrichtigt.

Normal ("Normal")

Der Benutzer wird benachrichtigt.

Schwerwiegend ("schwerwiegend")

Das System wird mit der letzten bekannten, fehlerfreien Konfiguration neu gestartet.

Kritisch ("Kritisch")

Das System versucht, mit einer fehlerfreien Konfiguration zu neu starten.

Unbekannt ("Unbekannt")

Die Ursache des Fehlers ist unbekannt.

ExitCode

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Dienststrukturen| SERVICE_STATUS|dwWin32ExitCode"), DisplayName ("Exit Code")

Windows-Fehlercode beim Definieren von Problemen, die beim Starten oder Beenden des Diensts auftreten. Diese Eigenschaft wird auf ERROR_SERVICE_SPECIFIC_ERROR (1066) festgelegt, wenn der Fehler in Bezug auf den Dienst eindeutig ist, der durch diese Klasse repräsentiert wird, und Informationen zu dem Fehler stehen in der ServiceSpecificExitCode -Eigenschaft zur Verfügung. Der Dienst legt diesen Wert auf NO_ERROR fest, wenn ausgeführt wird, und erneut bei normaler Beendigung.

Diese Eigenschaft wird von Win32_BaseService geerbt.

InstallDate

Datentyp: datetime

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Installationsdatum")

Das Objekt wurde installiert. Diese Eigenschaft benötigt keinen Wert, um anzugeben, dass das Objekt installiert ist.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Name

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schlüssel

Eindeutiger Bezeichner für den Dienst, der einen Hinweis auf die verwaltete Funktionalität bietet. Diese Funktionalität wird in der Eigenschaft Description des Objekts ausführlicher beschrieben.

Diese Eigenschaft wird von CIM_Service geerbt.

PathName

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Dienststrukturen| QUERY_SERVICE_CONFIG|lpBinaryPathName"), DisplayName ("Dateipfadname")

Vollqualifizierter Pfad zur Binärdatei des Diensts, die den Dienst implementiert.

Beispiel: "\SystemRoot\System32\drivers\afd.sys"

Diese Eigenschaft wird von Win32_BaseService geerbt.

ServiceSpecificExitCode

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Dienststrukturen| SERVICE_STATUS|dwServiceSpecificExitCode"), DisplayName ("serverspezifischer Exitcode")

Dienstspezifischer Fehlercode für Fehler, die auftreten, während der Dienst gestartet oder beendet wird. Die Exitcodes werden durch den Dienst definiert, der von dieser Klasse dargestellt wird. Dieser Wert wird nur festgelegt, wenn der ExitCode-EigenschaftswertERROR_SERVICE_SPECIFIC_ERROR (1066) ist.

Diese Eigenschaft wird von Win32_BaseService geerbt.

Servicetype

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Dienststrukturen| QUERY_SERVICE_CONFIG|dwServiceType"), DisplayName ("Diensttyp")

Der für aufrufende Prozesse bereitgestellte Diensttyp.

Diese Eigenschaft wird von Win32_BaseService geerbt.

Die Werte sind:

Kerneltreiber ("Kerneltreiber")

Dateisystemtreiber ("Dateisystemtreiber")

Adapter ("Adapter")

Erkennungstreiber ("Erkennungstreiber")

Eigener Prozess ("Eigener Prozess")

Freigabeprozess ("Freigabeprozess")

Interaktiver Prozess ("Interaktiver Prozess")

Started

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Started")

Der Dienst wurde gestartet.

Diese Eigenschaft wird von CIM_Service geerbt.

StartMode

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Startmodus")

Startmodus des Systemtreibers.

Diese Eigenschaft wird von Win32_BaseService geerbt.

Start ("Start")

Gerätetreiber, der vom Betriebssystemladeprogramm gestartet wird (gilt nur für Treiberdienste).

System ("System")

Gerätetreiber, der vom Initialisierungsprozess des Betriebssystems gestartet wird. Dieses Wert ist nur für Treiberdienste gültig.

Auto ("Auto")

Dienst, der während des Systemstarts automatisch vom Dienststeuerungs-Manager gestartet werden soll.

Manuell ("Manuell")

Dienst, der vom Dienststeuerungs-Manager gestartet werden soll, wenn ein Prozess die StartService-Methode aufruft.

Deaktiviert ("Deaktiviert")

Dienst, der nicht mehr gestartet werden kann.

StartName

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Dienststrukturen| QUERY_SERVICE_CONFIG|lpServiceStartName"), DisplayName ("Name des Startkontos")

Kontoname, unter dem der Dienst ausgeführt wird. Je nach Diensttyp kann der Kontoname in der Form Domänenname\Benutzername vorliegen. Der Dienstprozess wird bei der Ausführung mit einem dieser beiden Formulare protokolliert. Wenn das Konto zur integrierten Domäne gehört, kann .\Username angegeben werden. Wenn NULL angegeben ist, wird der Dienst als LocalSystem-Konto angemeldet. Bei Treibern auf Kernel- oder Systemebene enthält StartName den Treiberobjektnamen (d. h. \FileSystem\Rdr oder \Driver\Xns), den das Eingabe- und Ausgabesystem (E/A) zum Laden des Gerätetreibers verwendet. Wenn NULL angegeben ist, wird der Treiber mit einem Standardobjektnamen ausgeführt, der vom E/A-System basierend auf dem Dienstnamen erstellt wird.

Beispiel: "DWDOM\Admin"

Diese Eigenschaft wird von Win32_BaseService geerbt.

State

Datentyp: string

Zugriffstyp: Lese-/Schreibzugriff

Qualifizierer: MappingStrings ("Win32API| Dienststrukturen| SERVICE_STATUS|dwCurrentState "), DisplayName ("State")

Aktueller Status des Basisdiensts.

Diese Eigenschaft wird von Win32_BaseService geerbt.

Die Werte sind:

Beendet ("Beendet")

Start ausstehend ("Start ausstehend")

Ausstehend beenden ("Ausstehend")

Wird ausgeführt ("Wird ausgeführt")

Weiter ausstehend ("Weiter ausstehend")

Anhalten ausstehend ("Anhalten ausstehend")

Angehalten ("Angehalten")

Unbekannt ("Unbekannt")

Status

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen (10), DisplayName ("Status")

Aktuelle status des Objekts. Es können verschiedene betriebsbezogene und nicht operative Status definiert werden. Zu den Betriebsstatus gehören: "OK", "Heruntergestuft" und "Pred Fail" (ein Element, z. B. eine SMART-fähige Festplatte, funktioniert möglicherweise ordnungsgemäß, sagt aber in naher Zukunft einen Fehler voraus). Zu den nicht betriebsbereiten Status gehören: "Fehler", "Wird gestartet", "Wird beendet" und "Dienst". Letzteres, "Dienst", kann beim Spiegel-Resilvering eines Datenträgers, beim Erneutladen einer Benutzerberechtigungsliste oder bei anderen administrativen Aufgaben gelten. Nicht alle derartigen Arbeiten sind online, aber das verwaltete Element ist weder "OK" noch in einem der anderen Zustände.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Die Werte sind:

OK ("OK")

Fehler ("Fehler")

Degraded ("Degraded")

Unbekannt ("Unbekannt")

Pred Fail ("Pred Fail")

Wird gestartet ("Wird gestartet")

Beenden ("Wird beendet")

Dienst ("Dienst")

Gestresst ("Gestresst")

NonRecover ("NonRecover")

Kein Kontakt ("Kein Kontakt")

Lost Comm ("Lost Comm")

SystemCreationClassName

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: Propagiert ("CIM_System. CreationClassName"), CIM_Key, DisplayName ("Systemklassenname")

Geben Sie den Namen des Systems ein, das diesen Dienst hostet.

Diese Eigenschaft wird von CIM_Service geerbt.

Systemname

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: Propagiert ("CIM_System. Name"), CIM_Key, DisplayName ("Systemname")

Name des Systems, das diesen Dienst hostet.

Diese Eigenschaft wird von CIM_Service geerbt.

TagId

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Dienststrukturen| QUERY_SERVICE_CONFIG|dwTagId"), DisplayName ("Tag-ID")

Eindeutiger Tagwert für diesen Dienst in der Gruppe. Der Wert 0 (null) gibt an, dass dem Dienst kein Tag zugewiesen wurde. Ein Tag kann zum Starten des Bestelldiensts innerhalb einer Ladereihenfolgegruppe verwendet werden, indem ein Tagreihenfolgevektor in der Registrierung angegeben wird, die sich unter:

Diese Eigenschaft wird von Win32_BaseService geerbt.

HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\GroupOrderList.

Tags werden nur für Startdienste vom Kerneltreiber und Dateisystemtreiber ausgewertet, die über start- oder Systemstartmodi verfügen.

Bemerkungen

Die Win32_SystemDriver-Klasse wird von Win32_BaseService abgeleitet.

Beispiele

Das VBScript-Beispiel Listensystemtreiber zeigt installierte Systemtreiber in einer HTML-Datei an.

Im folgenden PowerShell-Beispiel werden eine Reihe von Eigenschaften von den ausgeführten Systemtreibern auf einem Computer abgerufen.

Get-WmiObject -Class Win32_SystemDriver | Where-Object -FilterScript {$_.State -eq "Running"} | Where-Object -FilterScript {$_.StartMode -eq "Manual"} | Format-Table -Property Name,DisplayName

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows Vista
Unterstützte Mindestversion (Server)
 WindowsServer 2008
Namespace
 Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Siehe auch

Win32_BaseService

Betriebssystemklassen