Win32_TerminalService-Klasse

  • Artikel

Die Win32_TerminalService WMI-Klasse ist eine Unterklasse der Win32_Service-Klasse . Win32_TerminalService stellt die Element-Eigenschaft der Win32_TerminalServiceToSetting-Zuordnung dar.

Die folgende Syntax wird vom MOF-Code vereinfacht und enthält alle definierten und geerbten Eigenschaften in alphabetischer Reihenfolge.

Syntax

[dynamic, provider("Win32_WIN32_TERMINALSERVICE_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer"), AMENDMENT]
class Win32_TerminalService : Win32_Service
{
  boolean  AcceptPause;
  boolean  AcceptStop;
  string   Caption;
  uint32   CheckPoint;
  string   CreationClassName;
  boolean  DelayedAutoStart;
  string   Description;
  boolean  DesktopInteract;
  string   DisplayName;
  string   ErrorControl;
  uint32   ExitCode;
  datetime InstallDate;
  string   Name;
  string   PathName;
  uint32   ProcessId;
  uint32   ServiceSpecificExitCode;
  string   ServiceType;
  boolean  Started;
  string   StartMode;
  string   StartName;
  string   State;
  string   Status;
  string   SystemCreationClassName;
  string   SystemName;
  uint32   TagId;
  uint32   WaitHint;
  uint32   DisconnectedSessions;
  uint32   TotalSessions;
};

Member

Die Win32_TerminalService-Klasse verfügt über die folgenden Membertypen:

Methoden

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

Methode BESCHREIBUNG
Veränderung Ändert einen Dienst.
ChangeStartMode Ändert den Startmodus eines Diensts.
Erstellen Erstellt einen neuen Dienst.
Löschen Löscht einen vorhandenen Dienst.
GetSecurityDescriptor Gibt die Sicherheitsbeschreibung zurück, die den Zugriff auf den Dienst steuert.
InterrogateService Fordert an, dass ein Dienst seinen Status an den Dienst-Manager aktualisiert.
PauseService Versucht, einen Dienst im angehaltenen Zustand zu platzieren.
ResumeService Versucht, einen Dienst im fortgesetzten Zustand zu platzieren.
SetSecurityDescriptor Schreibt eine aktualisierte Version der Sicherheitsbeschreibung, die den Zugriff auf den Dienst steuert.
Startservice Versucht, einen Dienst in den Startzustand zu versetzen.
StopService Versetzt einen Dienst in den Status beendet.
UserControlService Versucht, einen benutzerdefinierten Steuerelementcode an einen Dienst zu senden.

Eigenschaften

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

AcceptPause

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

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

Gibt an, ob der Dienst angehalten werden kann.

Diese Eigenschaft wird von Win32_BaseService geerbt.

AcceptStop

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

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

Gibt an, ob der Dienst beendet werden kann.

Diese Eigenschaft wird von Win32_BaseService geerbt.

Caption

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

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

Kurze Beschreibung des Diensts eine einzeilige Zeichenfolge.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Prüfpunkt

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Dienststrukturen| SERVICE_STATUS|dwCheckPoint"), DisplayName ("Check Point Count")

Wert, der der Dienst regelmäßig erhöht, um seinen Fortschritt während eines langen Start-, Stopp-, Pausen- oder Fortsetzungsvorgangs zu melden. Beispielsweise erhöht der Dienst diesen Wert, während er beim Starten jeden Schritt seiner Initialisierung abgeschlossen hat. Das Benutzeroberflächenprogramm, das den Vorgang für den Dienst aufruft, verwendet diesen Wert, um den Fortschritt des Diensts während eines langwierigen Vorgangs nachzuverfolgen. Dieser Wert ist ungültig und sollte null sein, wenn für den Dienst kein Start-, Stopp-, Pausen- oder Fortsetzungsvorgang aussteht.

Diese Eigenschaft wird von Win32_Service geerbt.

CreationClassName

Datentyp: Zeichenfolge

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.

DelayedAutoStart

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Dienststrukturen| SERVICE_DELAYED_AUTO_START_INFO|fDelayedAutostart"), DisplayName ("Verzögerter automatischer Start")

Wenn True, wird der Dienst gestartet, nachdem andere Dienste für den automatischen Start gestartet wurden, und eine kurze Verzögerung.

Windows Server 2012 R2, Windows 8.1, Windows Server 2012, Windows 8, Windows Server 2008 R2, Windows 7, Windows Server 2008 und Windows Vista: Diese Eigenschaft wird vor Windows Server 2016 und Windows 10 .

Diese Eigenschaft wird von Win32_Service geerbt.

Beschreibung

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Description")

Eine Beschreibung des Objekts.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

DesktopInteract

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

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

Gibt an, ob der Dienst Fenster auf dem Desktop erstellen oder mit ihnen kommunizieren kann und somit in irgendeiner Weise mit einem Benutzer interagieren kann. Interaktive Dienste müssen unter dem Lokalen Systemkonto ausgeführt werden. Die meisten Dienste sind nicht interaktiv; Das heißt, sie kommunizieren in keiner Weise mit dem Benutzer.

Diese Eigenschaft wird von Win32_BaseService geerbt.

DisconnectedSessions

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Die Anzahl der getrennten Sitzungen auf dem aktuellen Server. Diese Sitzungen nutzen möglicherweise weiterhin aktiv Serverressourcen, haben jedoch derzeit keine Netzwerkverbindung mit einem Client.

DisplayName

Datentyp: string

Zugriffstyp: Schreibgeschützt

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

Name des Diensts, wie im Snap-In Dienste angezeigt. Die maximale Länge der Zeichenfolge beträgt 256 Zeichen. Beachten Sie, dass der Anzeigename und der Dienstname (der in der Registrierung gespeichert ist) nicht immer identisch sind. Der DHCP-Clientdienst hat beispielsweise den Dienstnamen Dhcp, aber den Anzeigenamen DHCP-Client. Der Name wird im Dienststeuerungs-Manager in Groß- und Kleinschreibung beibehalten. Bei DisplayName-Vergleichen wird jedoch immer die Groß-/Kleinschreibung beachtet.

Einschränkung: 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. Der Wert gibt die Aktion an, die vom Startprogramm ausgeführt wird, wenn ein Fehler auftritt. Alle Fehler werden vom Computersystem protokolliert.

Ignore ("Ignore")

Der Benutzer wird nicht benachrichtigt.

Normal ("Normal")

Der Benutzer wird benachrichtigt. In der Regel handelt es sich dabei um ein Meldungsfeld, das den Benutzer über das Problem informiert.

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. Wenn der Dienst ein zweites Mal nicht gestartet werden kann, schlägt der Start fehl.

Unbekannt ("Unbekannt")

Der Schweregrad des Fehlers ist unbekannt.

Diese Eigenschaft wird von Win32_BaseService geerbt.

ExitCode

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

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

Windows-Fehlercode, der Fehler definiert, die beim Starten oder Beenden des Diensts auftreten. Diese Eigenschaft wird auf ERROR_SERVICE_SPECIFIC_ERROR (1066) festgelegt, wenn der Fehler für den von dieser Klasse dargestellten Dienst eindeutig ist, und Informationen zum Fehler in der ServiceSpecificExitCode-Eigenschaft verfügbar sind. 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")

Datumsobjekt installiert. Für diese Eigenschaft ist kein Wert erforderlich, 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 des Diensts, der einen Hinweis auf die verwaltete Funktionalität bietet. Diese Funktionalität wird in der Description-Eigenschaft des -Objekts beschrieben.

Diese Eigenschaft wird von CIM_ManagedSystemElement 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.

Processid

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Dienststrukturen| SERVICE_STATUS_PROCESS|dwProcessId"), DisplayName ("Prozess-ID")

Prozessbezeichner des Diensts.

Beispiel: 324

Diese Eigenschaft wird von Win32_Service 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 Wert der ExitCode-EigenschaftERROR_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.

Die Werte sind:

Kerneltreiber ("Kerneltreiber")

Dateisystemtreiber ("Dateisystemtreiber")

Adapter ("Adapter")

Erkennungstreiber ("Erkennungstreiber")

Eigener Prozess ("Eigener Prozess")

Freigabeprozess ("Freigabeprozess")

Interaktiver Prozess ("Interaktiver Prozess")

Diese Eigenschaft wird von Win32_BaseService geerbt.

Started

Datentyp: boolean

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Started")

Gibt an, ob der Dienst gestartet wird.

Diese Eigenschaft wird von CIM_Service geerbt.

StartMode

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Startmodus")

Startmodus des Windows-Basisdiensts.

Start ("Boot")

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

System ("System")

Der Gerätetreiber wurde vom Initialisierungsprozess des Betriebssystems gestartet. Dieses Wert ist nur für Treiberdienste gültig.

Auto ("Auto")

Der Dienst soll während des Systemstarts automatisch vom Dienstkontroll-Manager gestartet werden. Automatische Dienste werden auch dann gestartet, wenn sich ein Benutzer nicht anmeldet.

Manuell ("Manuell")

Dienst, der vom Dienststeuerungs-Manager gestartet werden soll, wenn ein Prozess die StartService-Methode aufruft. Diese Dienste werden erst gestartet, wenn sich ein Benutzer anmeldet und sie startet.

Deaktiviert ("Deaktiviert")

Dienst, der erst gestartet werden kann, wenn sein StartMode in Auto oder Manuell geändert wurde.

Diese Eigenschaft wird von CIM_Service geerbt.

StartName

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

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

Kontoname, unter dem ein Dienst ausgeführt wird. Je nach Diensttyp kann der Kontoname die Form "Domänenname\Benutzername" oder das UPN-Format ("Username@DomainName") haben. Der Dienstprozess wird mit einem dieser beiden Formulare protokolliert, wenn er ausgeführt wird. Wenn das Konto zur integrierten Domäne gehört, kann ".\Username" angegeben werden. Bei Treibern auf Kernel- oder Systemebene enthält StartName den Namen des Treiberobjekts (d. h. "\FileSystem\Rdr" oder "\Driver\Xns"), das das E/A-System zum Laden des Gerätetreibers verwendet. Wenn NULL angegeben wird, wird der Treiber außerdem 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: Zeichenfolge

Zugriffstyp: Lese-/Schreibzugriff

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

Aktueller Status des Basisdiensts.

Die Werte sind:

Beendet ("Beendet")

Start ausstehend ("Start ausstehend")

Ausstehend beenden ("Ausstehend beenden")

Ausführen ("Ausführen")

Weiter ausstehend ("Weiter ausstehend")

Anhalten ausstehend ("Anhalten ausstehend")

Angehalten ("Angehalten")

Unbekannt ("Unbekannt")

Windows Server 2008 und Windows Vista: Diese Eigenschaft ist schreibgeschützt vor Windows 7 und Windows Server 2008 R2.

Diese Eigenschaft wird von Win32_BaseService geerbt.

Status

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

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

Aktuelle status des Objekts. Es können verschiedene betriebs- und nicht-operative Status definiert werden. Zu den Betriebsstatus gehören: "OK", "Degraded" und "Pred Fail" (ein Element, z. B. ein SMART-fähiges Festplattenlaufwerk, funktioniert möglicherweise ordnungsgemäß, sagt aber einen Fehler in naher Zukunft voraus). Zu den nicht betriebsrelevanten Status zählen : "Error", "Starting", "Stop" und "Service". Letzteres, "Dienst", kann während Spiegel-Resilvering eines Datenträgers, beim Erneutladen einer Benutzerberechtigungsliste oder bei anderen Administrativen Arbeiten gelten. Nicht alle derartigen Arbeiten sind online, aber das verwaltete Element ist weder "OK" noch in einem der anderen Zuständen.

Die Werte sind:

OK ("OK")

Fehler ("Fehler")

Degraded ("Degraded")

Unbekannt ("Unbekannt")

Pred Fail ("Pred Fail")

Starten ("Start")

Beenden ("Beenden")

Dienst ("Dienst")

Gestresst ("Gestresst")

NonRecover ("NonRecover")

Kein Kontakt ("Kein Kontakt")

Lost Comm ("Lost Comm")

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

SystemCreationClassName

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Verteilt ("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: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Verteilt ("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 der Dienst über kein Tag verfügt. Ein Tag kann verwendet werden, um den Dienststart innerhalb einer Ladereihenfolgegruppe zu bestellen, indem ein Tagreihenfolgevektor in der Registrierung angegeben wird, die sich unter befindet:

HKEY_LOCAL_MACHINE\System\Currentcontrolset\Steuerung\ GroupOrderList

Tags werden nur für Kerneltreiber- und Dateisystemtreiber-Starttypdienste ausgewertet, die über Start- oder Systemstartmodi verfügen.

Diese Eigenschaft wird von Win32_BaseService geerbt.

TotalSessions

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Die Gesamtzahl der Sitzungen auf dem aktuellen Server. Dies umfasst sowohl verbundene als auch getrennte Sitzungen.

WaitHint

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API| Dienststrukturen| SERVICE_STATUS|dwWaitHint"), DisplayName ("Geschätzte Wartezeit")

Geschätzte Zeit in Millisekunden für einen ausstehenden Start-, Stopp-, Pausen- oder Fortsetzungsvorgang. Nachdem die angegebene Zeit verstrichen ist, führt der Dienst den nächsten Aufruf der SetServiceStatus-Methode mit einem inkrementierten CheckPoint-Wert oder einer Änderung in CurrentState durch. Wenn die von WaitHint angegebene Zeitspanne verstrichen ist und CheckPoint nicht erhöht wurde oder CurrentState sich nicht geändert hat, geht der Dienststeuerungs-Manager oder das Dienststeuerungsprogramm davon aus, dass ein Fehler aufgetreten ist.

Diese Eigenschaft wird von Win32_Service geerbt.

Bemerkungen

Da die Win32_TerminalService-Klasse eine Unterklasse der Win32_Service-Klasse ist, erbt die Klasse alle Eigenschaften und Methoden von Win32_Service.

Win32_TerminalServiceSetting wird Win32_TerminalService als Setting-Eigenschaft der Win32_TerminalServiceToSetting-Zuordnung zugeordnet.

Win32_TSSessionDirectory wird Win32_TerminalService als Setting-Eigenschaft der Win32_TSSessionDirectorySetting-Zuordnung zugeordnet.

MOF-Dateien (Managed Object Format) enthalten die Definitionen für WMI-Klassen (Windows Management Instrumentation). MOF-Dateien werden nicht als Teil des Microsoft Windows Software Development Kit (SDK) installiert. Sie werden auf dem Server installiert, wenn Sie die zugeordnete Rolle mithilfe der Server-Manager hinzufügen. Weitere Informationen zu MOF-Dateien finden Sie unter Managed Object Format (MOF).

Anforderungen

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

Siehe auch

Win32_Service

Win32_TerminalServiceToSetting

Win32_TSSessionDirectory

Win32_BaseService

CIM_Service