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
TSCfgWmi.mof
DLL
TSCfgWmi.dll

Siehe auch

CIM _ LogicalElement

Win32 _ TerminalServiceSetting

Win32 _ TerminalTerminalSetting