Win32_TSSessionSetting classe
La classe WMI Win32_TSSessionSetting définit les paramètres de configuration de la classe Win32_Terminal , tels que les limites de temps et les actions de déconnexion et de reconnexion.
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_TSSESSIONSETTING_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer\\WinStations"), AMENDMENT]
class Win32_TSSessionSetting : Win32_TerminalSetting
{
string Caption;
string Description;
datetime InstallDate;
string Name;
string Status;
string TerminalName;
uint32 ActiveSessionLimit;
uint32 BrokenConnectionAction;
uint32 BrokenConnectionPolicy;
uint32 DisconnectedSessionLimit;
uint32 IdleSessionLimit;
uint32 PolicySourceActiveSessionLimit;
uint32 PolicySourceBrokenConnectionAction;
uint32 PolicySourceDisconnectedSessionLimit;
uint32 PolicySourceIdleSessionLimit;
uint32 PolicySourceReconnectionPolicy;
uint32 ReconnectionPolicy;
uint32 TimeLimitPolicy;
uint32 EnableTimeoutWarning;
};
Membres
La classe Win32_TSSessionSetting a les types de membres suivants :
Méthodes
La classe Win32_TSSessionSetting a ces méthodes.
| Méthode | Description |
|---|---|
| BrokenConnection | Définit les propriétés de connexion rompues incluses dans cette classe. |
| Timelimit | Définit les propriétés de limite de temps incluses dans cette classe. |
Propriétés
La classe Win32_TSSessionSetting possède ces propriétés.
-
ActiveSessionLimit
-
-
Type de données : uint32
-
Type d'accès : Lecture seule
Durée maximale, en millisecondes, allouée à une session active. La valeur 0 spécifie une durée infinie.
-
-
BrokenConnectionAction
-
-
Type de données : uint32
-
Type d'accès : Lecture seule
Action que le serveur effectue sur la session lorsqu’une connexion a été interrompue en raison d’une perte réseau ou d’un dépassement des limites de temps.
-
-
Déconnecter (0)
-
L’utilisateur est déconnecté de la session.
-
Terminer (1)
-
La session est définitivement supprimée du serveur.
BrokenConnectionPolicy
-
Type de données : uint32
-
Type d’accès : Lecture/écriture
Stratégie que le serveur utilise pour déterminer quand interrompre une connexion en raison d’une perte de réseau ou d’un dépassement des limites de temps.
Remplacement de serveur (1)
Les paramètres de stratégie de déconnexion de l’utilisateur sont remplacés par le serveur.
Par utilisateur (0)
Les paramètres de stratégie de déconnexion de l’utilisateur sont en vigueur.
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.
DisconnectedSessionLimit
-
Type de données : uint32
-
Type d'accès : Lecture seule
Intervalle de temps, en millisecondes, après lequel une session déconnectée est terminée. La valeur 0 spécifie une durée infinie.
EnableTimeoutWarning
-
Type de données : uint32
-
Type d’accès : Lecture/écriture
Active l’avertissement de délai d’expiration.
Windows 7, Windows Server 2008 R2, Windows Vista et Windows Server 2008 : Cette propriété n’est pas disponible.
IdleSessionLimit
-
Type de données : uint32
-
Type d'accès : Lecture seule
Intervalle de temps, en millisecondes, après lequel une session inactive est terminée. La valeur 0 spécifie une durée infinie.
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.
PolicySourceActiveSessionLimit
-
Type de données : uint32
-
Type d'accès : Lecture seule
Indique si la propriété ActiveSessionLimit est configurée par le serveur, la stratégie de groupe ou par défaut.
0
Serveur
1
Stratégie de groupe
2
Default
PolicySourceBrokenConnectionAction
-
Type de données : uint32
-
Type d'accès : Lecture seule
Indique si la propriété BrokenConnectionAction est configurée par le serveur, la stratégie de groupe ou par défaut.
0
Serveur
1
Stratégie de groupe
2
Default
PolicySourceDisconnectedSessionLimit
-
Type de données : uint32
-
Type d'accès : Lecture seule
Indique si la propriété DisconnectedSessionLimit est configurée par le serveur, la stratégie de groupe ou par défaut.
0
Serveur
1
Stratégie de groupe
2
Default
PolicySourceIdleSessionLimit
-
Type de données : uint32
-
Type d'accès : Lecture seule
Indique si la propriété IdleSessionLimit est configurée par le serveur, la stratégie de groupe ou par défaut.
0
Serveur
1
Stratégie de groupe
2
Default
PolicySourceReconnectionPolicy
-
Type de données : uint32
-
Type d'accès : Lecture seule
Indique si la propriété ReconnectPolicy est configurée par le serveur, la stratégie de groupe ou par défaut.
0
Serveur
1
Stratégie de groupe
2
Default
ReconnectionPolicy
-
Type de données : uint32
-
Type d’accès : Lecture/écriture
Spécifie si un utilisateur doit utiliser le client précédent pour se reconnecter à une session déconnectée.
Tout client (0)
Tout client sera utilisé pour se reconnecter.
Client précédent (1)
Le client précédent utilisé dans une connexion sera utilisé pour se reconnecter.
É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.
TimeLimitPolicy
-
Type de données : uint32
-
Type d’accès : Lecture/écriture
Stratégie que le serveur utilise pour déterminer les limites de temps pour les sessions utilisateur.
Par utilisateur (0)
Les paramètres de stratégie de limite de temps de l’utilisateur sont en vigueur.
Remplacement du serveur (1)
Les paramètres de stratégie de limite de temps de l’utilisateur sont remplacés par le serveur.
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 vous tentez de le faire 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 dans le but d’ajouter ou de 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 la valeur 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 |
|