Win32_TerminalService, classe
La classe WMI Win32_TerminalService est une sous-classe de la classe Win32_Service . Win32_TerminalService représente la propriété Element de l’association Win32_TerminalServiceToSetting .
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.
Syntaxe
[dynamic, provider("Win32_WIN32_TERMINALSERVICE_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer"), AMENDMENT]
class Win32_TerminalService : Win32_Service
{
boolean AcceptPause;
boolean AcceptStop;
string Caption;
uint32 CheckPoint;
string CreationClassName;
boolean DelayedAutoStart;
string Description;
boolean DesktopInteract;
string DisplayName;
string ErrorControl;
uint32 ExitCode;
datetime InstallDate;
string Name;
string PathName;
uint32 ProcessId;
uint32 ServiceSpecificExitCode;
string ServiceType;
boolean Started;
string StartMode;
string StartName;
string State;
string Status;
string SystemCreationClassName;
string SystemName;
uint32 TagId;
uint32 WaitHint;
uint32 DisconnectedSessions;
uint32 TotalSessions;
};
Membres
La classe Win32_TerminalService a les types de membres suivants :
Méthodes
La classe Win32_TerminalService possède ces méthodes.
Méthode | Description |
---|---|
Changement | Modifie un service. |
ChangeStartMode | Modifie le mode de démarrage d’un service. |
Créer | Crée un nouveau service. |
Supprimer | Supprime un service existant. |
GetSecurityDescriptor | Retourne le descripteur de sécurité qui contrôle l’accès au service. |
InterrogationService | Demande à un service de mettre à jour son état sur le gestionnaire de services. |
PauseService | Tente de placer un service à l’état suspendu. |
ResumeService | Tente de placer un service à l’état de reprise. |
SetSecurityDescriptor | Écrit une version mise à jour du descripteur de sécurité qui contrôle l’accès au service. |
StartService | Tente de placer un service à l’état de démarrage. |
StopService | Place un service à l’état arrêté. |
UserControlService | Tente d’envoyer un code de contrôle défini par l’utilisateur à un service. |
Propriétés
La classe Win32_TerminalService possède ces propriétés.
-
AcceptPause
-
-
Type de données : booléen
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32API| Structures de service | SERVICE_STATUS|dwControlsAccepted| SERVICE_ACCEPT_PAUSE_CONTINUE »), DisplayName (« Service accepte la pause »)
Indique si le service peut être suspendu.
Cette propriété est héritée de Win32_BaseService.
-
-
AcceptStop
-
-
Type de données : booléen
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32API| Structures de service | SERVICE_STATUS|dwControlsAccepted| SERVICE_ACCEPT_STOP »), DisplayName (« Service accepte l’arrêt »)
Indique si le service peut être arrêté.
Cette propriété est héritée de Win32_BaseService.
-
-
Caption
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MaxLen (64), DisplayName (« Caption »)
Brève description du service : chaîne d’une ligne.
Cette propriété est héritée de CIM_ManagedSystemElement.
-
-
Checkpoint
-
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32API| Structures de service | SERVICE_STATUS|dwCheckPoint « ), DisplayName (« Check Point Count »)
Valeur que le service incrémente régulièrement pour signaler sa progression pendant une opération de démarrage, d’arrêt, de pause ou de poursuite. Par exemple, le service incrémente cette valeur à mesure qu’il termine chaque étape de son initialisation au démarrage. Le programme d’interface utilisateur qui appelle l’opération sur le service utilise cette valeur pour suivre la progression du service pendant une opération de longue durée. Cette valeur n’est pas valide et doit être égale à zéro lorsque le service n’a pas d’opération de démarrage, d’arrêt, de pause ou de poursuite en attente.
Cette propriété est héritée de Win32_Service.
-
-
CreationClassName
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : CIM_Key, DisplayName (« Nom de la classe »)
Nom de la première classe concrète à apparaître dans la chaîne d’héritage utilisée dans la création d’un instance. Lorsqu’elle est utilisée avec les autres propriétés clés de la classe, cette propriété permet à toutes les instances de cette classe et de ses sous-classes d’être identifiées de manière unique.
Cette propriété est héritée de CIM_Service.
-
-
DelayedAutoStart
-
-
Type de données : booléen
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32API| Structures de service | SERVICE_DELAYED_AUTO_START_INFO|fDelayedAutostart »), DisplayName (« Démarrage automatique différé »)
Si la valeur est True, le service est démarré après le démarrage d’autres services de démarrage automatique plus un court délai.
Windows Server 2012 R2, Windows 8.1, Windows Server 2012, Windows 8, Windows Server 2008 R2, Windows 7, Windows Server 2008 et Windows Vista : cette propriété n’est pas prise en charge avant Windows Server 2016 et Windows 10 .
Cette propriété est héritée de Win32_Service.
-
-
Description
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : DisplayName (« Description »)
Description de l’objet.
Cette propriété est héritée de CIM_ManagedSystemElement.
-
-
DesktopInteract
-
-
Type de données : booléen
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32API| Structures de service | QUERY_SERVICE_CONFIG|dwServiceType| SERVICE_INTERACTIVE_PROCESS »), DisplayName (« Interactions avec le bureau »)
Indique si le service peut créer ou communiquer avec des fenêtres sur le bureau, et donc interagir d’une manière ou d’une autre avec un utilisateur. Les services interactifs doivent s’exécuter sous le compte système local. La plupart des services ne sont pas interactifs; autrement dit, ils ne communiquent avec l’utilisateur d’aucune façon.
Cette propriété est héritée de Win32_BaseService.
-
-
Sessions déconnectées
-
-
Type de données : uint32
-
Type d'accès : Lecture seule
Nombre de sessions déconnectées sur le serveur actuel. Ces sessions peuvent toujours consommer activement des ressources serveur, mais elles n’ont actuellement aucune connexion réseau avec un client.
-
-
DisplayName
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32API| Structures de service| QUERY_SERVICE_CONFIG|lpDisplayName »), DisplayName (« Nom d’affichage »)
Nom du service tel qu’il est indiqué dans le composant logiciel enfichable Services. Cette chaîne a une longueur maximale de 256 caractères. Notez que le nom complet et le nom du service (qui est stocké dans le Registre) ne sont pas toujours identiques. Par exemple, le service client DHCP a le nom de service Dhcp, mais le nom d’affichage DHCP Client. Le nom est conservé à la casse dans le Gestionnaire de contrôle des services. Toutefois, les comparaisons DisplayName ne respectent toujours pas la casse.
Contrainte : accepte la même valeur que la propriété Name .
Exemple : « Atdisk »
Cette propriété est héritée de Win32_BaseService.
-
-
ErrorControl
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32API| Structures de service| QUERY_SERVICE_CONFIG|dwErrorControl »), DisplayName (« Gravité de l’échec de démarrage »)
Gravité de l’erreur si ce service ne parvient pas à démarrer au démarrage. La valeur indique l’action effectuée par le programme de démarrage en cas d’échec. Toutes les erreurs sont journalisées par le système informatique.
-
-
Ignorer (« Ignorer »)
-
L'utilisateur n'est pas notifié.
-
Normal (« Normal »)
-
L'utilisateur est notifié. En règle générale, il s’agit d’un message qui informe l’utilisateur du problème.
-
Sévère (« Sévère »)
-
Le système est redémarré avec la dernière bonne configuration connue.
-
Critique (« Critique »)
-
Le système tente de redémarrer avec une bonne configuration. Si le service ne parvient pas à démarrer une deuxième fois, le démarrage échoue.
-
Inconnu (« Inconnu »)
-
La gravité de l’erreur est inconnue.
Cette propriété est héritée de Win32_BaseService.
ExitCode
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32API| Structures de service| SERVICE_STATUS|dwWin32ExitCode »), DisplayName (« Code de sortie »)
Code d’erreur Windows qui définit les erreurs rencontrées lors du démarrage ou de l’arrêt du service. Cette propriété est définie sur ERROR_SERVICE_SPECIFIC_ERROR (1066) lorsque l’erreur est propre au service représenté par cette classe et que des informations sur l’erreur sont disponibles dans la propriété ServiceSpecificExitCode . Le service définit cette valeur sur NO_ERROR lors de l’exécution, puis à nouveau lors de l’arrêt normal.
Cette propriété est héritée de Win32_BaseService.
InstallDate
-
Type de données : datetime
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« MIF. DMTF| ComponentID|001.5 »), DisplayName (« Date d’installation »)
L’objet Date est installé. Cette propriété ne nécessite pas de valeur pour indiquer que l’objet est installé.
Cette propriété est héritée de CIM_ManagedSystemElement.
Nom
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : Clé
Identificateur unique du service qui fournit une indication de la fonctionnalité gérée. Cette fonctionnalité est décrite dans la propriété Description de l’objet .
Cette propriété est héritée de CIM_ManagedSystemElement.
PathName
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32API| Structures de service| QUERY_SERVICE_CONFIG|lpBinaryPathName »), DisplayName (« Nom du chemin de fichier »)
Chemin d’accès complet au fichier binaire de service qui implémente le service.
Exemple : « \SystemRoot\System32\drivers\afd.sys »
Cette propriété est héritée de Win32_BaseService.
Processid
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32API| Structures de service| SERVICE_STATUS_PROCESS|dwProcessId »), DisplayName (« ID de processus »)
Identificateur de processus du service.
Exemple : 324
Cette propriété est héritée de Win32_Service.
ServiceSpecificExitCode
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32API| Structures de service| SERVICE_STATUS|dwServiceSpecificExitCode »), DisplayName (« Code de sortie spécifique au serveur »)
Code d’erreur spécifique au service pour les erreurs qui se produisent pendant le démarrage ou l’arrêt du service. Les codes de sortie sont définis par le service représenté par cette classe. Cette valeur est définie uniquement lorsque la valeur de la propriété ExitCode est ERROR_SERVICE_SPECIFIC_ERROR (1066).
Cette propriété est héritée de Win32_BaseService.
Servicetype
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32API| Structures de service| QUERY_SERVICE_CONFIG|dwServiceType »), DisplayName (« Type de service »)
Type de service fourni aux processus appelants.
Les valeurs sont :
Pilote de noyau (« pilote de noyau »)
Pilote de système de fichiers (« pilote de système de fichiers »)
Adaptateur (« Adaptateur »)
Recognizer Driver (« Recognizer Driver »)
Propre processus (« propre processus »)
Processus de partage (« processus de partage »)
Processus interactif (« processus interactif »)
Cette propriété est héritée de Win32_BaseService.
Get Started with Custom Speech Service (Prise en main de Custom Speech Service)
-
Type de données : booléen
-
Type d'accès : Lecture seule
-
Qualificateurs : DisplayName (« Démarré »)
Indique si le service est démarré ou non.
Cette propriété est héritée de CIM_Service.
StartMode
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : DisplayName (« Mode Démarrer »)
Mode démarrer du service de base Windows.
Démarrage (« Démarrage »)
Pilote de périphérique démarré par le chargeur du système d’exploitation (valide uniquement pour les services de pilote).
Système (« Système »)
Pilote de périphérique démarré par le processus d’initialisation du système d’exploitation. Cette valeur est uniquement valide pour les services de pilote.
Auto (« Auto »)
Le service doit être démarré automatiquement par le Gestionnaire de contrôle des services lors du démarrage du système. Les services automatiques sont démarrés même si un utilisateur ne se connecte pas.
Manuel (« Manuel »)
Service à démarrer par le Gestionnaire de contrôle de service lorsqu’un processus appelle la méthode StartService . Ces services ne démarrent que si un utilisateur se connecte et les démarre.
Désactivé (« Désactivé »)
Service qui ne peut pas être démarré tant que son Mode de démarrage n’est pas remplacé par Auto ou Manual.
Cette propriété est héritée de CIM_Service.
StartName
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32API| Structures de service | QUERY_SERVICE_CONFIG|lpServiceStartName »), DisplayName (« Nom du compte de départ »)
Nom du compte sous lequel un service s’exécute. Selon le type de service, le nom du compte peut être au format « DomainName\Username » ou au format UPN (« Username@DomainName »). Le processus de service est journalisé à l’aide de l’un de ces deux formulaires lorsqu’il s’exécute. Si le compte appartient au domaine intégré, vous pouvez spécifier .\Username. Pour les pilotes au niveau du noyau ou du système, StartName contient le nom de l’objet du pilote (c’est-à-dire, « \FileSystem\Rdr » ou « \Driver\Xns ») que le système d’E/S utilise pour charger le pilote de périphérique. En outre, si NULL est spécifié, le pilote s’exécute avec un nom d’objet par défaut créé par le système d’E/S en fonction du nom du service.
Exemple : « DWDOM\Administration »
Cette propriété est héritée de Win32_BaseService.
State
-
Type de données : chaîne
-
Type d’accès : Lecture/écriture
-
Qualificateurs : MappingStrings (« Win32API| Structures de service | SERVICE_STATUS|dwCurrentState « ), DisplayName (« State »)
État actuel du service de base.
Les valeurs sont :
Arrêté (« Arrêté »)
Démarrer en attente (« Démarrer en attente »)
Arrêter en attente (« Arrêter en attente »)
Exécution (« En cours d’exécution »)
Continuer en attente (« Continuer en attente »)
Suspendre en attente (« Suspendre en attente »)
Suspendu (« Suspendu »)
Inconnu (« Inconnu »)
Windows Server 2008 et Windows Vista : Cette propriété est en lecture seule avant Windows 7 et Windows Server 2008 R2.
Cette propriété est héritée de Win32_BaseService.
État
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MaxLen (10), DisplayName (« Status »)
Status actuelle de l’objet. Différents états opérationnels et non opérationnels peuvent être définis. Les états opérationnels sont les suivants : « OK », « Détérioré » et « Échec antérieur » (un élément, tel qu’un disque dur smart, peut fonctionner correctement, mais prédire une défaillance dans un avenir proche). Les états non opératoires sont les suivants : « Erreur », « Démarrage », « Arrêt » et « Service ». Ce dernier, « Service », peut s’appliquer pendant miroir redimensionnement d’un disque, le rechargement d’une liste d’autorisations utilisateur ou tout autre travail administratif. Tous ces travaux ne sont pas en ligne, mais l’élément managé n’est ni « OK » ni dans l’un des autres états.
Les valeurs sont :
OK (« OK »)
Erreur (« Erreur »)
Dégradé (« Dégradé »)
Inconnu (« Inconnu »)
Échec du prédé (« Échec anticipé »)
Démarrage (« Démarrage »)
Arrêt (« Arrêt »)
Service (« Service »)
Stressé (« Stressé »)
NonRecover (« NonRecover »)
Aucun contact (« Aucun contact »)
Lost Comm (« Lost Comm »)
Cette propriété est héritée de CIM_ManagedSystemElement.
SystemCreationClassName
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : propagé (« CIM_System. CreationClassName « ), CIM_Key, DisplayName (« System Class Name »)
Nom du type du système qui héberge ce service.
Cette propriété est héritée de CIM_Service.
SystemName
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : propagé (« CIM_System. Nom »), CIM_Key, DisplayName (« Nom du système »)
Nom du système qui héberge ce service.
Cette propriété est héritée de CIM_Service.
TagId
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32API| Structures de service | QUERY_SERVICE_CONFIG|dwTagId « ), DisplayName (« Id de balise »)
Valeur d’étiquette unique pour ce service dans le groupe. La valeur 0 (zéro) indique que le service n’a pas de balise. Une balise peut être utilisée pour commander le démarrage du service au sein d’un groupe d’ordre de chargement en spécifiant un vecteur d’ordre de balise dans le Registre situé à l’adresse suivante :
HKEY_LOCAL_MACHINE\Système\Currentcontrolset\Contrôle\ GroupOrderList
Les balises sont évaluées uniquement pour les services de type de démarrage de pilote de noyau et de pilote de système de fichiers qui ont les modes Démarrage ou Démarrage du système.
Cette propriété est héritée de Win32_BaseService.
TotalSessions
-
Type de données : uint32
-
Type d'accès : Lecture seule
Nombre total de sessions sur le serveur actuel. Cela inclut les sessions connectées et déconnectées.
WaitHint
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32API| Structures de service | SERVICE_STATUS|dwWaitHint »), DisplayName (« Temps d’attente estimé »)
Temps estimé nécessaire, en millisecondes, pour une opération de démarrage, d’arrêt, de pause ou de poursuite en attente. Une fois le temps spécifié écoulé, le service effectue son prochain appel à la méthode SetServiceStatus avec une valeur CheckPoint incrémentée ou une modification dans CurrentState. Si la durée spécifiée par WaitHint passe et que CheckPoint n’a pas été incrémenté ou que CurrentState n’a pas changé, le gestionnaire de contrôle de service ou le programme de contrôle de service supposent qu’une erreur s’est produite.
Cette propriété est héritée de Win32_Service.
Notes
Étant donné que la classe Win32_TerminalService est une sous-classe de la classe Win32_Service , la classe hérite de toutes les propriétés et méthodes de Win32_Service.
Win32_TerminalServiceSetting est associé à Win32_TerminalService en tant que propriété Setting de l’association Win32_TerminalServiceToSetting .
Win32_TSSessionDirectory est associé à Win32_TerminalService en tant que propriété Setting de l’association Win32_TSSessionDirectorySetting .
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 |
MOF |
|
DLL |
|