Win32_Terminal classe

La classe WMI Win32_Terminal représente un terminal.

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, overwrite, provider("Win32_WIN32_TERMINAL_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer\\WinStations"), AMENDMENT]
class Win32_Terminal : CIM_LogicalElement
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  uint32   fEnableTerminal;
  uint32   LoggedOnUsers;
  string   TerminalName;
};

Membres

La classe Win32_Terminal a les types de membres suivants :

• Méthodes
• Propriétés

Méthodes

La classe Win32_Terminal a ces méthodes.

Méthode	Description
Créer	Crée un terminal avec des paramètres par défaut qui peuvent être personnalisés à l’aide des propriétés et méthodes des classes Win32_TerminalSetting .
Supprimer	Supprime le terminal spécifié.
Activer	Désactive ou active le terminal.
Renommer	Renomme le terminal.

Propriétés

La classe Win32_Terminal a 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.

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.

fEnableTerminal

Type de données : uint32

Type d'accès : Lecture seule

Spécifie si le terminal spécifié est désactivé ou activé.

FALSE (0)

Le terminal est désactivé.

TRUE (1)

Le terminal est activé.

InstallDate

Type de données : datetime

Type d'accès : Lecture seule

Qualificateurs : Mappingstrings (« MIF. DMTF| ComponentID|001.5 »)

Date à laquelle l’objet a été installé. 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.

LoggedOnUsers

Type de données : uint32

Type d'accès : Lecture seule

Nombre de sessions connectées pour le terminal.

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.

É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

Qualificateurs : clé

Nom unique qui identifie le instance du terminal.

Notes

Win32_Terminal est associé à Win32_TerminalSetting en tant que propriété Element de l’association Win32_TerminalTerminalSetting .

Les classes suivantes sont des sous-classes de la classe Win32_Terminal : Win32_TSGeneralSetting, Win32_TSLogonSetting, Win32_TSSessionSetting, Win32_TSEnvironmentSetting, Win32_TSRemoteControlSetting, Win32_TSClientSetting, Win32_TSNetworkAdapterSetting, Win32_TSNetworkAdapterListSetting, Win32_TSPermissionsSetting et Win32_TSAccount.

Notez 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

CIM_LogicalElement

Win32_TerminalServiceSetting

Win32_TerminalTerminalSetting