Win32 _ Terminal-Klasse
Die WMI-Klasse "Win32 _ Terminal" stellt ein Terminal dar.
Die folgende Syntax wird aus 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 folgende Typen von Membern:
Methoden
Die Win32 _ Terminal-Klasse verfügt über diese Methoden.
| Methode | Beschreibung |
|---|---|
| Erstellen | Erstellt ein Terminal mit Standardeinstellungen, das mithilfe der Eigenschaften und Methoden der Win32 _ TerminalSetting-Klassen angepasst werden kann. |
| 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: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MaxLen (64)
Kurze Beschreibung (einzeilige Zeichenfolge) des Objekts.
Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.
-
-
Beschreibung
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
Eine Beschreibung des Objekts.
Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.
-
-
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: Zuordnungszeichenfolgen ("MIF. DMTF | ComponentID | 001.5")
Das Datum, an dem das Objekt installiert wurde. Das Fehlen eines Werts gibt nicht an, dass das Objekt nicht installiert ist.
Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.
LoggedOnUsers
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Anzahl der angemeldeten Sitzungen für das Terminal.
Name
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
Der Name des Objekts.
Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.
Status
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MaxLen (10)
Aktueller Status des Objekts. Es können verschiedene Betriebs- und Nichtoperationsstatus definiert werden. Betriebsstatus: "OK", "Heruntergestuft" und "Pred Fail" (ein Element, z. B. ein SMART-fähiges Festplattenlaufwerk, funktioniert möglicherweise ordnungsgemäß, sagt aber einen Fehler in naher Zukunft vorher). Nichtoperationale Status: "Error", "Starting", "Stopping" und "Service". Letzteres, "Dienst", kann beim Spiegelungsresilvering eines Datenträgers, beim erneuten Laden einer Benutzerberechtigungsliste oder bei anderen administrativen Arbeiten angewendet werden. Nicht alle diese Arbeiten sind online, aber das verwaltete Element ist weder "OK" noch in einem der anderen Zustände.
Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.
("OK")
("Fehler")
("Heruntergestuft")
("Unbekannt")
("Pred Fail")
("Wird gestartet")
("Wird beendet")
("Dienst")
TerminalName
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: key
Der eindeutige Name, der die Instanz des Terminals identifiziert.
Hinweise
Win32 _ Terminal ist Win32 _ TerminalSetting als Elementeigenschaft 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 _ TSPermissionsSettingund Win32 _ TSAccount.
Beachten Sie, dass Winstations, die der Konsolensitzung zugeordnet sind, nicht auf die Methoden und Eigenschaften dieser Klasse zugreifen kann. Wenn dies versucht wird, indem "Console" als Wert der TerminalName-Eigenschaft angegeben wird, geben 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 \ \ CIMV2 \ TerminalServices-Stammnamespace herzustellen, muss die Authentifizierungsebene Paketdatenschutz enthalten. Bei C/C++-Aufrufen ist dies eine Authentifizierungsebene von RPC _ C _ AUTHN _ LEVEL _ PKT _ PRIVACY. Bei Visual Basic- und Skriptaufrufen ist dies die Authentifizierungsebene WbemAuthenticationLevelPktPrivacy oder "pktPrivacy" mit dem Wert 6. Das folgende Beispiel Visual Basic Scripting Edition (VBScript) zeigt, wie Sie eine Verbindung mit einem Remotecomputer mit Paketschutz herstellen.
strComputer = "RemoteServer1"
Set objServices = GetObject( _
"winmgmts:{authenticationLevel=pktPrivacy}!Root/CIMv2/TerminalServices")
Managed Object Format -Dateien (MOF) enthalten die Definitionen für WMI-Klassen (Windows Management Instrumentation, verwaltungsinstrumentation). 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) |
Windows Server 2008 |
| Namespace |
\ \ CiMv2-Stammterminaldienste |
| MOF |
|
| DLL |
|