Win32_TSEnvironmentSetting-Klasse
Die Win32_TSEnvironmentSetting WMI-Klasse definiert die Konfigurationseinstellungen für die Win32_Terminal Klasse, einschließlich der anfänglichen Programmrichtlinie.
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_TSENVIRONMENTSETTING_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer\\WinStations"), AMENDMENT]
class Win32_TSEnvironmentSetting : Win32_TerminalSetting
{
string Caption;
string Description;
datetime InstallDate;
string Name;
string Status;
string TerminalName;
uint32 ClientWallPaper;
string InitialProgramPath;
uint32 InitialProgramPolicy;
uint32 PolicySourceClientWallPaper;
uint32 PolicySourceInitialProgramPath;
uint32 PolicySourceStartIn;
string Startin;
};
Member
Die Win32_TSEnvironmentSetting-Klasse verfügt über folgende Membertypen:
Methoden
Die Win32_TSEnvironmentSetting-Klasse verfügt über diese Methoden.
| Methode | BESCHREIBUNG |
|---|---|
| InitialProgram | Legt die Startprogrammeigenschaften fest, die in dieser Klasse enthalten sind. |
| SetClientWallPaper | Legt die ClientWallPaper-Eigenschaft fest . |
Eigenschaften
Die Win32_TSEnvironmentSetting-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_ManagedSystemElement geerbt.
-
-
ClientWallPaper
-
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Gibt an, ob das Hintergrundbild auf dem Client angezeigt wird. Wenn das Hintergrundbild nicht angezeigt wird, können Systemressourcen eingespart werden, indem die Zeit verringert wird, die zum Erneuten Streichen des Bildschirms erforderlich ist.
-
-
False (0)
-
Das Hintergrundbild wird auf dem Client nicht angezeigt.
-
True (1)
-
Das Hintergrundbild wird auf dem Client angezeigt.
Beschreibung
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
Eine Beschreibung des Objekts.
Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.
InitialProgramPath
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
Der Name und der Pfad des Programms, das der Benutzer unmittelbar nach der Anmeldung beim RD-Sitzungshostserver ausführen wird.
InitialProgramPolicy
-
Datentyp: uint32
-
Zugriffstyp: Lese-/Schreibzugriff
Die Richtlinie, die der Server verwendet, um den Pfad des Startprogramms und den Dateinamen sowie den Namen des Ordners zu bestimmen, in dem sich der Server befindet.
Pro Benutzer (0)
Die Startprogrammeinstellungen des Benutzers sind in Kraft.
Serverüberschreibung (1)
Die Einstellungen für das Startprogramm des Benutzers werden vom Server überschrieben.
Single-App-Modus (2)
In dieser Sitzung wird nur eine einzelne Anwendung ausgeführt. Die Informationen zum Startprogramm werden ignoriert.
InstallDate
-
Datentyp: datetime
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Zuordnungszeichenfolgen ("MIF. DMTF| ComponentID|001.5")
Das Datum, an dem das Objekt installiert wurde. Ein fehlender Wert gibt nicht an, dass das Objekt nicht installiert ist.
Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.
Name
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
Der Name des Objekts.
Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.
PolicySourceClientWallPaper
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Gibt an, ob die ClientWallPaper-Eigenschaft vom Server, der Gruppenrichtlinie oder standardmäßig konfiguriert wird.
0
Server
1
Gruppenrichtlinie
2
Standard
PolicySourceInitialProgramPath
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Gibt an, ob die InitialProgramPath-Eigenschaft vom Server, der Gruppenrichtlinie oder standardmäßig konfiguriert wird.
0
Server
1
Gruppenrichtlinie
2
Standard
PolicySourceStartIn
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Gibt an, ob die StartIn-Eigenschaft vom Server, der Gruppenrichtlinie oder standardmäßig konfiguriert wird.
0
Server
1
Gruppenrichtlinie
2
Standard
Startin
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
Der Pfad des Arbeitsverzeichnisses des Programms, das der Benutzer unmittelbar nach der Anmeldung beim RD-Sitzungshostserver ausführen wird.
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.
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 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 Paketschutz 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 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 |
|
| DLL |
|