Win32_Terminal-Klasse
Die Win32_Terminal WMI-Klasse stellt ein Terminal dar.
Die folgende Syntax wird vom MOF-Code vereinfacht und enthält alle definierten und geerbten Eigenschaften in alphabetischer Reihenfolge. Referenzinformationen zu Methoden finden Sie in der Tabelle der Methoden weiter unten in diesem Thema.
Syntax
[dynamic, overwrite, provider("Win32_WIN32_TERMINAL_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer\\WinStations"), AMENDMENT]
class Win32_Terminal : CIM_LogicalElement
{
string Caption;
string Description;
datetime InstallDate;
string Name;
string Status;
uint32 fEnableTerminal;
uint32 LoggedOnUsers;
string TerminalName;
};
Member
Die Win32_Terminal-Klasse verfügt über die folgenden Membertypen:
Methoden
Die Win32_Terminal-Klasse verfügt über diese Methoden.
| Methode | BESCHREIBUNG |
|---|---|
| Erstellen | Erstellt ein Terminal mit Standardeinstellungen, die mithilfe der Eigenschaften und Methoden der Win32_TerminalSetting-Klassen angepasst werden können. |
| Löschen | Löscht das angegebene Terminal. |
| Aktivieren | Deaktiviert oder aktiviert das Terminal. |
| Umbenennen | Benennt das Terminal um. |
Eigenschaften
Die Win32_Terminal-Klasse verfügt über diese Eigenschaften.
-
Caption
-
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MaxLen (64)
Kurze Beschreibung (einzeilige Zeichenfolge) des Objekts.
Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.
-
-
Beschreibung
-
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Eine Beschreibung des Objekts.
Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.
-
-
fEnableTerminal
-
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Gibt an, ob das angegebene Terminal deaktiviert oder aktiviert ist.
-
-
FALSE (0)
-
Das Terminal ist deaktiviert.
-
TRUE (1)
-
Das Terminal ist aktiviert.
InstallDate
-
Datentyp: datetime
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Mappingstrings ("MIF. DMTF| ComponentID|001.5")
Das Datum der Installation des Objekts. Ein Fehlender Wert bedeutet nicht, dass das Objekt nicht installiert ist.
Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.
LoggedOnUsers
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Anzahl angemeldeter Sitzungen für das Terminal.
Name
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Der Name des Objekts.
Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.
Status
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MaxLen (10)
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ände.
Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.
("OK")
("Fehler")
("Beeinträchtigt")
("Unbekannt")
("Pred Fail")
("Start")
("Beenden")
("Dienst")
TerminalName
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Schlüssel
Der eindeutige Name, der die instance des Terminals identifiziert.
Bemerkungen
Win32_Terminal ist Win32_TerminalSetting als Element-Eigenschaft der Win32_TerminalTerminalSetting-Zuordnung zugeordnet.
Die folgenden Klassen sind Unterklassen der Win32_Terminal-Klasse : Win32_TSGeneralSetting, Win32_TSLogonSetting, Win32_TSSessionSetting, Win32_TSEnvironmentSetting, Win32_TSRemoteControlSetting, Win32_TSClientSetting, Win32_TSNetworkAdapterSetting, Win32_TSNetworkAdapterListSetting, Win32_TSPermissionsSetting und Win32_TSAccount.
Beachten Sie, dass winstations, die der Konsolensitzung zugeordnet sind, nicht auf die Methoden und Eigenschaften dieser Klasse zugreifen können. Wenn versucht wird, dies zu tun, indem "Console" als Wert der TerminalName-Eigenschaft angegeben wird, geben die Methoden dieses Objekts WBEM_E_NOT_SUPPORTED zurück. Dieser Fehlercode wird auch zurückgegeben, wenn eine Fensterstation versucht, Methoden dieses Objekts aufzurufen, um die Sicherheitseigenschaften der Konten LocalSystem, LocalService oder NetworkService hinzuzufügen oder zu ändern.
Um eine Verbindung mit dem Namespace \root\CIMV2\TerminalServices herzustellen, muss die Authentifizierungsebene den Schutz des Pakets enthalten. Bei C/C++-Aufrufen ist dies eine Authentifizierungsebene von RPC_C_AUTHN_LEVEL_PKT_PRIVACY. Für Visual Basic- und Skriptaufrufe ist dies eine Authentifizierungsebene von WbemAuthenticationLevelPktPrivacy oder "pktPrivacy" mit dem Wert 6. Das folgende Visual Basic Scripting Edition (VBScript)-Beispiel zeigt, wie Sie eine Verbindung mit einem Remotecomputer mit Paketschutz herstellen.
strComputer = "RemoteServer1"
Set objServices = GetObject( _
"winmgmts:{authenticationLevel=pktPrivacy}!Root/CIMv2/TerminalServices")
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 des Server-Manager hinzufügen. Weitere Informationen zu MOF-Dateien finden Sie unter Verwaltetes Objektformat (MOF).
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
WindowsServer 2008 |
| Namespace |
Root\CIMv2\TerminalServices |
| MOF |
|
| DLL |
|