Freigeben über

Win32_TSSessionSetting-Klasse

  • Artikel

Die Win32_TSSessionSetting WMI-Klasse definiert Konfigurationseinstellungen für die Win32_Terminal-Klasse , z. B. Zeitlimits, Trennungs- und Wiederverbindungsaktionen.

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, provider("Win32_WIN32_TSSESSIONSETTING_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer\\WinStations"), AMENDMENT]
class Win32_TSSessionSetting : Win32_TerminalSetting
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  string   TerminalName;
  uint32   ActiveSessionLimit;
  uint32   BrokenConnectionAction;
  uint32   BrokenConnectionPolicy;
  uint32   DisconnectedSessionLimit;
  uint32   IdleSessionLimit;
  uint32   PolicySourceActiveSessionLimit;
  uint32   PolicySourceBrokenConnectionAction;
  uint32   PolicySourceDisconnectedSessionLimit;
  uint32   PolicySourceIdleSessionLimit;
  uint32   PolicySourceReconnectionPolicy;
  uint32   ReconnectionPolicy;
  uint32   TimeLimitPolicy;
  uint32   EnableTimeoutWarning;
};

Member

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

Methoden

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

Methode BESCHREIBUNG
BrokenConnection Legt die fehlerhaften Verbindungseigenschaften fest, die in dieser Klasse enthalten sind.
Timelimit Legt die in dieser Klasse enthaltenen Zeitlimiteigenschaften fest.

Eigenschaften

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

ActiveSessionLimit

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Die maximale Zeit in Millisekunden, die einer aktiven Sitzung zugeordnet ist. Der Wert 0 gibt eine unendliche Zeitspanne an.

BrokenConnectionAction

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Die Aktion, die der Server für die Sitzung ausführt, wenn eine Verbindung aufgrund eines Netzwerkverlustes unterbrochen wurde oder zeitlimits überschritten wurde.

Trennen ( 0)

Der Benutzer wird von der Sitzung getrennt.

Beenden (1)

Die Sitzung wird endgültig vom Server gelöscht.

BrokenConnectionPolicy

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

Die Richtlinie, die der Server verwendet, um zu bestimmen, wann eine Verbindung aufgrund von Netzwerkverlust oder Überschreitung von Zeitlimits unterbrochen werden soll.

Serverüberschreibung (1)

Die Einstellungen der Verbindungsrichtlinie des Benutzers werden vom Server überschrieben.

Pro Benutzer (0)

Die Richtlinieneinstellungen für die Verbindungstrennung des Benutzers sind in Kraft.

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.

DisconnectedSessionLimit

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Das Zeitintervall in Millisekunden, nach dem eine getrennte Sitzung beendet wird. Der Wert 0 gibt eine unendliche Zeitspanne an.

EnableTimeoutWarning

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

Aktiviert die Timeoutwarnung.

Windows 7, Windows Server 2008 R2, Windows Vista und Windows Server 2008: Diese Eigenschaft ist nicht verfügbar.

IdleSessionLimit

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Das Zeitintervall in Millisekunden, nach dem eine Leerlaufsitzung beendet wird. Der Wert 0 gibt eine unendliche Zeitspanne an.

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.

Name

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Der Name des Objekts.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

PolicySourceActiveSessionLimit

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Gibt an, ob die ActiveSessionLimit-Eigenschaft vom Server, der Gruppenrichtlinie oder standardmäßig konfiguriert ist.

0

Server

1

Gruppenrichtlinie

2

Standard

PolicySourceBrokenConnectionAction

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Gibt an, ob die BrokenConnectionAction-Eigenschaft vom Server, der Gruppenrichtlinie oder standardmäßig konfiguriert ist.

0

Server

1

Gruppenrichtlinie

2

Standard

PolicySourceDisconnectedSessionLimit

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Gibt an, ob die DisconnectedSessionLimit-Eigenschaft vom Server, der Gruppenrichtlinie oder standardmäßig konfiguriert wird.

0

Server

1

Gruppenrichtlinie

2

Standard

PolicySourceIdleSessionLimit

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Gibt an, ob die IdleSessionLimit-Eigenschaft vom Server, der Gruppenrichtlinie oder standardmäßig konfiguriert wird.

0

Server

1

Gruppenrichtlinie

2

Standard

PolicySourceReconnectionPolicy

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Gibt an, ob die ReconnectPolicy-Eigenschaft vom Server, der Gruppenrichtlinie oder standardmäßig konfiguriert wird.

0

Server

1

Gruppenrichtlinie

2

Standard

ReconnectionPolicy

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

Gibt an, ob ein Benutzer den vorherigen Client verwenden muss, um eine verbindung mit einer getrennten Sitzung wiederherzustellen.

Beliebiger Client (0)

Ein beliebiger Client wird verwendet, um die Verbindung wiederherzustellen.

Vorheriger Client (1)

Der vorherige Client, der in einer Verbindung verwendet wurde, wird verwendet, um die Verbindung wiederherzustellen.

Status

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen (10)

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.

("OK")

("Fehler")

("Heruntergestuft")

("Unbekannt")

("Pred Fail")

("Wird gestartet")

("Wird beendet")

("Dienst")

TerminalName

Datentyp: string

Zugriffstyp: Schreibgeschützt

Der Name des Terminals.

Diese Eigenschaft wird von Win32_TerminalSetting geerbt.

TimeLimitPolicy

Datentyp: uint32

Zugriffstyp: Lese-/Schreibzugriff

Die Richtlinie, die der Server verwendet, um Zeitlimits für Benutzersitzungen zu bestimmen.

Pro Benutzer (0)

Die Zeitlimitrichtlinieneinstellungen des Benutzers sind in Kraft.

Serverüberschreibung (1)

Die Zeitlimitrichtlinieneinstellungen des Benutzers werden vom Server überschrieben.

Bemerkungen

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 methoden dieses Objekts WBEM_E_NOT_SUPPORTED zurück. Dieser Fehlercode wird auch zurückgegeben, wenn eine Fensterstation versucht, Methoden dieses Objekts zum Hinzufügen oder Ändern der Sicherheitseigenschaften der Konten LocalSystem, LocalService oder NetworkService aufzurufen.

Um eine Verbindung mit dem Namespace "root\CIMV2\TerminalServices" herzustellen, muss die Authentifizierungsebene den Paketschutz enthalten. Bei C/C++-Aufrufen wäre dies eine Authentifizierungsebene von RPC_C_AUTHN_LEVEL_PKT_PRIVACY. Bei Visual Basic- und Skriptaufrufen wäre 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 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\TerminalServices
MOF
TSCfgWmi.mof
DLL
TSCfgWmi.dll

Siehe auch

Win32_TerminalSetting

CIM_Setting