Partager via


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

Voir aussi

Win32_TerminalSetting