Win32_TSSessionDirectory-Klasse
Definiert die Konfigurationseinstellungen des Remotedesktop-Verbindungsbrokers (RD-Verbindungsbroker) für die Win32_TSSessionDirectorySetting-Klasse .
Hinweis
In Windows Server 2008 R2 wurde der Name des Terminaldienste-Sitzungsbrokers (TS-Sitzungsbroker) in RD-Verbindungsbroker geändert. Diese Eigenschaften gelten für alle unterstützten Betriebssysteme, sofern nicht anders angegeben.
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_TSSESSIONDIRECTORY_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer"), AMENDMENT]
class Win32_TSSessionDirectory : CIM_Setting
{
string Caption;
string Description;
datetime InstallDate;
string Name;
string Status;
string SessionDirectoryLocation;
uint32 PolicySourceSessionDirectoryLocation;
uint32 SessionDirectoryActive;
uint32 PolicySourceSessionDirectoryActive;
uint32 SessionDirectoryExposeServerIP;
uint32 PolicySourceSessionDirectoryExposeServerIP;
string SessionDirectoryClusterName;
uint32 PolicySourceLoadBalancing;
uint32 GetLoadBalancingState;
uint32 GetServerWeight;
uint32 PolicySourceSessionDirectoryClusterName;
string SessionDirectoryIPAddress;
uint32 GetTSRedirectorMode;
uint32 PolicySourceTSRedirectorMode;
};
Member
Die Win32_TSSessionDirectory-Klasse verfügt über folgende Membertypen:
Methoden
Die Win32_TSSessionDirectory-Klasse verfügt über diese Methoden.
| Methode | BESCHREIBUNG |
|---|---|
| CreateUserDiskTemplate | Erstellt eine Benutzerdatenträgervorlage. |
| DisableUserVhd | Deaktiviert eine Benutzerprofil-VHD. |
| EnableUserVhd | Aktiviert eine Benutzerprofil-VHD auf einem RDSH-Server. |
| GetCurrentRedirectableAddresses | Ruft die aktuell konfigurierte Liste der geeigneten DNS-Adressen und den Umleitungstyp ab. |
| GetRedirectableAddresses | Ruft die gesamte Liste der geeigneten DNS-Adressen ab. |
| PingSessionDirectory | Überprüft, ob der RD-Verbindungsbrokerserver verfügbar ist. |
| SetCurrentRedirectableAddresses | Legt die konfigurierte Liste der geeigneten DNS-Adressen und den Umleitungstyp fest. |
| SetLoadBalancingState | Legt den Wert fest, um anzugeben, ob der Server am Lastenausgleich des RD-Verbindungsbrokers beteiligt ist. |
| SetServerWeight | Legt den Servergewichtungswert für den RD-Verbindungsbroker-Lastenausgleich fest. |
| SetSessionDirectoryActive | Deaktiviert und aktiviert den RD-Verbindungsbroker. |
| SetSessionDirectoryExposeServerIP | Legt die SessionDirectoryExposeServerIP-Eigenschaft fest. |
| SetSessionDirectoryProperty | Legt die SessionDirectoryLocation-Eigenschaft oder die SessionDirectoryClusterName-Eigenschaft fest. |
| SetTSRedirectorMode | Diese Methode ist nicht verfügbar. |
Eigenschaften
Die Win32_TSSessionDirectory-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.
-
-
GetLoadBalancingState
-
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Gibt an, ob der Server für die Teilnahme am RD-Verbindungsbroker-Lastenausgleich konfiguriert ist.
-
-
0
-
Der Server ist nicht für die Teilnahme am RD-Verbindungsbroker-Lastenausgleich konfiguriert.
-
1
-
Der Server ist für die Teilnahme am RD-Verbindungsbroker-Lastenausgleich konfiguriert.
GetServerWeight
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Ruft den Servergewichtungswert ab, der im Rd-Verbindungsbroker-Lastenausgleich verwendet wird.
GetTSRedirectorMode
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Gibt an, ob der Server für die Umleitung von Remotedesktopdiensten konfiguriert ist.
0
Der Server ist so konfiguriert, dass er als Remotedesktopdienste-Redirector fungiert.
1
Der Server ist nicht so konfiguriert, dass er als Remotedesktopdienste-Umleitung fungiert.
Windows Server 2008: Diese Eigenschaft ist nicht verfügbar.
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.
PolicySourceLoadBalancing
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Gibt an, ob die GetLoadBalancingState-Eigenschaft vom Server oder von einer Gruppenrichtlinie konfiguriert wird.
0 (0x0)
Server
1 (0x1)
Gruppenrichtlinie
PolicySourceSessionDirectoryActive
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Gibt an, ob die SessionDirectoryActive-Eigenschaft vom Server oder von einer Gruppenrichtlinie konfiguriert wird.
0 (0x0)
Server
1 (0x1)
Gruppenrichtlinie
PolicySourceSessionDirectoryClusterName
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Gibt an, ob die SessionDirectoryClusterName-Eigenschaft vom Server oder von einer Gruppenrichtlinie konfiguriert wird.
0 (0x0)
Server
1 (0x1)
Gruppenrichtlinie
PolicySourceSessionDirectoryExposeServerIP
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Gibt an, ob die SessionDirectoryExposeServerIP-Eigenschaft vom Server oder von einer Gruppenrichtlinie konfiguriert wird.
0 (0x0)
Server
1 (0x1)
Gruppenrichtlinie
PolicySourceSessionDirectoryLocation
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Gibt an, ob die SessionDirectoryLocation-Eigenschaft vom Server oder von einer Gruppenrichtlinie konfiguriert wird.
0 (0x0)
Server
1 (0x1)
Gruppenrichtlinie
PolicySourceTSRedirectorMode
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Diese Eigenschaft ist nicht verfügbar.
Windows Server 2008 R2: Gibt an, ob die GetTSRedirectorMode-Eigenschaft vom Server oder von einer Gruppenrichtlinie konfiguriert wird.
0 (0x0)
Server
1 (0x1)
Gruppenrichtlinie
SessionDirectoryActive
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Schlüssel
Gibt an, ob Remotedesktopdienste am RD-Verbindungsbroker beteiligt sind.
FALSE (0)
Die Remotedesktopdienste-Teilnahme am RD-Verbindungsbroker ist deaktiviert.
TRUE (1)
Die Remotedesktopdienste-Teilnahme am RD-Verbindungsbroker ist aktiviert.
SessionDirectoryClusterName
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Die virtuelle IP-Adresse des Clusters, zu dem der RD-Sitzungshostserver gehört.
SessionDirectoryExposeServerIP
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Gibt an, ob der Abruf der IP-Adresse des RD-Verbindungsbrokers zulässig ist.
FALSE (0)
Der Abruf wird verweigert.
TRUE (1)
Der Abruf ist zulässig.
SessionDirectoryIPAddress
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Lese-/Schreibzugriff
Die IP-Adresse des LAN-Adapters, der vom Sitzungsverzeichnis verwendet wird.
SessionDirectoryLocation
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Der NETZWERK-DNS-Name oder die IP-Adresse des Servers, auf dem der RD-Verbindungsbrokerdienst ausgeführt wird.
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")
Bemerkungen
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 einem Wert von sechs.
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")
In Windows Server 2008 wurde der Name des Features Terminal services Session Directory in Terminal Services Session Broker geändert.
In Windows Server 2008 R2 wurde der Name des Features Terminaldienste-Sitzungsbroker in Remotedesktopverbindungsbroker geändert.
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) |
Nicht unterstützt |
| Unterstützte Mindestversion (Server) |
WindowsServer 2008 |
| Namespace |
Root\CIMv2\TerminalServices |
| MOF |
|
| DLL |
|