_Classe TSSessionSetting Win32

La classe WMI Win32 _ TSSessionSetting définit des paramètres de configuration pour la classe de _ Terminal Win32 , tels que les limites de temps, les actions de déconnexion et de reconnexion.

La syntaxe suivante est simplifiée à partir du code MOF et comprend 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 possède les types de membres suivants :

Méthodes

La classe Win32 _ TSSessionSetting possède 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 a 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 de réseau ou de délais.

Déconnecter (0)

L’utilisateur est déconnecté de la session.

Terminate (1)

La session est définitivement supprimée du serveur.

BrokenConnectionPolicy

Type de données : UInt32

Type d’accès : lecture/écriture

La stratégie utilisée par le serveur pour déterminer quand arrêter une connexion en raison d’une perte de réseau ou de délais.

Serveur-override (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 activé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.

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 arrêté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 d’expiration du délai d’attente.

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 à 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.

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.

N’importe quel client (0)

N’importe quel 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)

État actuel de l’objet. Divers États opérationnels et inopérationnels peuvent être définis. Les États opérationnels sont les suivants : « OK », « détérioré » et « échec prévu » (un élément, tel qu’un lecteur de disque dur intelligent, peut fonctionner correctement, mais prédire une défaillance dans un avenir proche). Les États qui ne sont pas opérationnels sont les suivants : « erreur », « démarrage », « arrêt » et « service ». Le dernier, « service », peut s’appliquer pendant la réargentation en miroir d’un disque, le rechargement d’une liste d’autorisations utilisateur ou d’autres tâches administratives. Tous les travaux de ce type ne sont pas en ligne, mais l’élément géré n’est ni « OK », ni de l’un des autres États.

Cette propriété est héritée de CIM _ ManagedSystemElement.

(« OK »)

(« Erreur »)

(« Détérioré »)

("Inconnu")

(« Échec prédit »)

(« 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

La stratégie utilisée par le serveur pour déterminer les limites de temps pour les sessions utilisateur.

Par utilisateur (0)

Les paramètres de stratégie de limites horaires de l’utilisateur sont activés.

Remplacement de serveur (1)

Les paramètres de stratégie de limites horaires de l’utilisateur sont remplacés par le serveur.

Notes

Sachez que les winstations associés à la session de console ne peuvent pas accéder aux méthodes et aux 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 _ non _ pris en charge. Ce code d’erreur est également renvoyé si une station Windows 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 se connecter à l’espace de noms « root \ cimv2 \ licences TS », le niveau d’authentification doit inclure la confidentialité du paquet. Pour les appels C/C++, il s’agit d’un niveau d’authentification de la _ _ _ _ _ confidentialité du niveau d’authentification RPC c. pour les Visual Basic et les appels de script, il s’agit d’un niveau d’authentification WbemAuthenticationLevelPktPrivacy ou « pktPrivacy », avec une valeur de 6. l’exemple VBScript (Visual Basic scripting Edition) suivant montre comment se connecter à un ordinateur distant avec la confidentialité du paquet.

strComputer = "RemoteServer1" 
Set objServices = GetObject( _
    "winmgmts:{authenticationLevel=pktPrivacy}!Root/CIMv2/TerminalServices")

les fichiers format MOF (MOF) contiennent les définitions des classes Windows Management Instrumentation (WMI). 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 de l’Gestionnaire de serveur. Pour plus d’informations sur les fichiers MOF, consultez format MOF (MOF).

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows Vista
Serveur minimal pris en charge
Windows Server 2008
Espace de noms
Racine \ cimv2 \ licences TS
MOF
TSCfgWmi. mof
DLL
TSCfgWmi.dll

Voir aussi

_TerminalSetting Win32

_Paramètre CIM