classe Win32_TSEnvironmentSetting
La classe WMI Win32_TSEnvironmentSetting définit les paramètres de configuration de la classe Win32_Terminal , y compris la stratégie de programme initiale.
La syntaxe suivante est simplifiée à partir du code MOF et inclut toutes les propriétés définies et héritées, par ordre alphabétique. Pour obtenir des informations de référence sur les méthodes, consultez le tableau des méthodes plus loin dans cette rubrique.
Syntaxe
[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;
};
Membres
La classe Win32_TSEnvironmentSetting a les types de membres suivants :
Méthodes
La classe Win32_TSEnvironmentSetting a ces méthodes.
Méthode | Description |
---|---|
InitialProgram | Définit les propriétés du programme de démarrage incluses dans cette classe. |
SetClientWallPaper | Définit la propriété ClientWallPaper . |
Propriétés
La classe Win32_TSEnvironmentSetting possède ces propriétés.
-
Caption
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MaxLen (64)
Brève description (chaîne d’une ligne) de l’objet.
Cette propriété est héritée de CIM_ManagedSystemElement.
-
-
ClientWallPaper
-
-
Type de données : uint32
-
Type d'accès : Lecture seule
Spécifie si l’image de papier peint s’affiche sur le client. Le fait de ne pas afficher l’image de papier peint peut économiser des ressources système en réduisant le temps nécessaire pour repeindre l’écran.
-
-
False (0)
-
L’image de papier peint n’est pas affichée sur le client.
-
True (1)
-
L’image de papier peint s’affiche sur le client.
Description
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Description de l’objet.
Cette propriété est héritée de CIM_ManagedSystemElement.
InitialProgramPath
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Nom et chemin d’accès du programme que l’utilisateur exécutera immédiatement après s’être connecté au serveur hôte de session Bureau à distance.
InitialProgramPolicy
-
Type de données : uint32
-
Type d’accès : Lecture/écriture
Stratégie que le serveur utilise pour déterminer le chemin d’accès du programme de démarrage et le nom du fichier, ainsi que le nom du dossier dans lequel il se trouve.
Par utilisateur (0)
Les paramètres du programme de démarrage de l’utilisateur sont en vigueur.
Remplacement de serveur (1)
Les paramètres du programme de démarrage de l’utilisateur sont remplacés par le serveur.
Mode application unique (2)
Une seule application sera exécutée dans cette session. Les informations du programme de démarrage sont ignorées.
InstallDate
-
Type de données : datetime
-
Type d'accès : Lecture seule
-
Qualificateurs : mappingstrings (« MIF. DMTF| ComponentID|001.5 »)
Date d’installation de l’objet. L’absence d’une valeur n’indique pas que l’objet n’est pas installé.
Cette propriété est héritée de CIM_ManagedSystemElement.
Nom
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Nom de l'objet.
Cette propriété est héritée de CIM_ManagedSystemElement.
PolicySourceClientWallPaper
-
Type de données : uint32
-
Type d'accès : Lecture seule
Indique si la propriété ClientWallPaper est configurée par le serveur, la stratégie de groupe ou par défaut.
0
Serveur
1
Stratégie de groupe
2
Default
PolicySourceInitialProgramPath
-
Type de données : uint32
-
Type d'accès : Lecture seule
Indique si la propriété InitialProgramPath est configurée par le serveur, la stratégie de groupe ou par défaut.
0
Serveur
1
Stratégie de groupe
2
Default
PolicySourceStartIn
-
Type de données : uint32
-
Type d'accès : Lecture seule
Indique si la propriété StartIn est configurée par le serveur, la stratégie de groupe ou par défaut.
0
Serveur
1
Stratégie de groupe
2
Default
Startin
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Chemin d’accès du répertoire de travail du programme que l’utilisateur exécutera immédiatement après s’être connecté au serveur hôte de session Bureau à distance.
État
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MaxLen (10)
Status actuelle de l’objet. Différents états opérationnels et non opérationnels peuvent être définis. Les états opérationnels incluent : « OK », « Détérioré » et « Échec anticipé » (un élément, tel qu’un lecteur de disque dur smart, peut fonctionner correctement, mais prédire une défaillance dans un avenir proche). Les états non coopératifs incluent : « Erreur », « Démarrage », « Arrêt » et « Service ». Ce dernier, « Service », peut s’appliquer lors de la miroir-resilver d’un disque, du rechargement d’une liste d’autorisations utilisateur ou d’autres tâches administratives. Tout ce travail n’est pas en ligne, mais l’élément managé n’est ni « OK », ni dans l’un des autres états.
Cette propriété est héritée de CIM_ManagedSystemElement.
(« OK »)
(« Erreur »)
(« Détérioré »)
(« Inconnu »)
(« Échec antérieur »)
(« Démarrage »)
(« Arrêt »)
(« Service »)
TerminalName
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Nom du terminal.
Cette propriété est héritée de Win32_TerminalSetting.
Notes
N’oubliez pas que les winstations associées à la session de console ne peuvent pas accéder aux méthodes et propriétés de cette classe. Si une tentative est effectuée en spécifiant « Console » comme valeur de la propriété TerminalName , les méthodes de cet objet retournent WBEM_E_NOT_SUPPORTED. Ce code d’erreur est également retourné si une station de fenêtre tente d’appeler des méthodes de cet objet pour ajouter ou modifier les propriétés de sécurité des comptes LocalSystem, LocalService ou NetworkService.
Pour vous connecter à l’espace de noms \root\CIMV2\TerminalServices, le niveau d’authentification doit inclure la confidentialité des paquets. Pour les appels C/C++, il s’agit d’un niveau d’authentification de RPC_C_AUTHN_LEVEL_PKT_PRIVACY. Pour les appels Visual Basic et de script, il s’agit d’un niveau d’authentification de WbemAuthenticationLevelPktPrivacy ou « pktPrivacy », avec une valeur de 6. L’exemple Visual Basic Scripting Edition (VBScript) suivant montre comment se connecter à un ordinateur distant avec la confidentialité des paquets.
strComputer = "RemoteServer1"
Set objServices = GetObject( _
"winmgmts:{authenticationLevel=pktPrivacy}!Root/CIMv2/TerminalServices")
Les fichiers MOF (Managed Object Format) contiennent les définitions des classes WMI (Windows Management Instrumentation). Les fichiers MOF ne sont pas installés dans le cadre du Kit de développement logiciel (SDK) Microsoft Windows. Ils sont installés sur le serveur lorsque vous ajoutez le rôle associé à l’aide du Gestionnaire de serveur. Pour plus d’informations sur les fichiers MOF, consultez Managed Object Format (MOF).
Spécifications
Condition requise | Valeur |
---|---|
Client minimal pris en charge |
Windows Vista |
Serveur minimal pris en charge |
Windows Server 2008 |
Espace de noms |
Root\CIMv2\TerminalServices |
MOF |
|
DLL |
|