Win32_TSAccount classe
La classe WMI Win32_TSAccount autorise la suppression d’un compte qui existe sur le Win32_Terminal et la modification des autorisations existantes.
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_TSACCOUNT_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer\\WinStations"), AMENDMENT]
class Win32_TSAccount : Win32_TerminalSetting
{
string Caption;
string Description;
datetime InstallDate;
string Name;
string Status;
string TerminalName;
string AccountName;
uint32 AuditFail;
uint32 AuditSuccess;
uint32 PermissionsAllowed;
uint32 PermissionsDenied;
string SID;
};
Membres
La classe Win32_TSAccount comporte les types de membres suivants :
Méthodes
La classe Win32_TSAccount a ces méthodes.
| Méthode | Description |
|---|---|
| Supprimer | Supprime le compte d’utilisateur, de groupe ou d’ordinateur spécifié. |
| ModifyAuditPermissions | Modifie la granularité du jeu d’autorisations d’audit du compte spécifié. |
| ModifyPermissions | Définit un jeu d’autorisations plus granulaire sur le compte spécifié. |
Propriétés
La classe Win32_TSAccount a ces propriétés.
-
AccountName
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : clé
Nom actuel du compte. Le nom de domaine est inclus.
-
-
AuditFail
-
-
Type de données : uint32
-
Type d'accès : Lecture seule
Spécifie les autorisations des services d’hôte de session Bureau à distance qui sont auditées pour une condition d’échec. La valeur de cette propriété est un masque de bits, qui peut être défini sur une ou plusieurs des valeurs de la propriété PermissionsAllowed .
-
-
WINSTATION_QUERY=0x1 (0)
-
WINSTATION_SET=0x2 (1)
-
WINSTATION_LOGOFF=0x4 (2)
-
WINSTATION_VIRTUAL | STANDARD_RIGHTS_REQUIRED = 0xF008 (3)
-
WINSTATION_SHADOW=0x10 (4)
-
WINSTATION_LOGON=0x20 (5)
-
WINSTATION_MSG=0x80 (6)
-
WINSTATION_CONNECT=0x100 (7)
-
WINSTATION_DISCONNECT=0x200 (8)
AuditSuccess
-
Type de données : uint32
-
Type d'accès : Lecture seule
Spécifie les autorisations spécifiques au serveur hôte de session Bureau à distance qui sont auditées pour une condition de réussite. La valeur de cette propriété est un masque de bits, qui peut être défini sur une ou plusieurs des valeurs de la propriété PermissionsAllowed .
WINSTATION_QUERY=0x1 (0)
WINSTATION_SET=0x2 (1)
WINSTATION_LOGOFF=0x4WINSTATION_VIRTUAL | STANDARD_RIGHTS_REQUIRED = 0xF008 (2)
WINSTATION_SHADOW=0x10 (3)
WINSTATION_LOGON=0x20 (4)
WINSTATION_MSG=0x80 (5)
WINSTATION_CONNECT=0x100 (6)
WINSTATION_DISCONNECT=0x200 (7)
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.
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.
AutorisationsAllowed
-
Type de données : uint32
-
Type d'accès : Lecture seule
Spécifie les autorisations des services Bureau à distance autorisées pour le compte. La valeur de cette propriété est un masque de bits, qui peut être défini sur une ou plusieurs des valeurs suivantes.
WINSTATION_QUERY=0x1 (1)
Autorisation d’interroger des informations sur une session.
WINSTATION_SET (2)
Autorisation de modifier les paramètres de connexion.
WINSTATION_RESET (64)
Autorisation de réinitialiser ou de mettre fin à une session ou à une connexion.
WINSTATION_VIRTUAL | STANDARD_RIGHTS_REQUIRED (983048)
Autorisation d’utiliser des canaux virtuels. Les canaux virtuels fournissent un accès à partir d’un programme serveur aux appareils clients.
WINSTATION_SHADOW (16)
Autorisation de masquer ou de contrôler à distance la session d’un autre utilisateur.
WINSTATION_LOGON (32)
Autorisation de se connecter à une session sur le serveur.
WINSTATION_LOGOFF (4)
Autorisation de déconnecter un utilisateur d’une session.
WINSTATION_MSG (128)
Autorisation d’envoyer un message à la session d’un autre utilisateur.
WINSTATION_CONNECT (256)
Autorisation de connexion à une autre session.
WINSTATION_DISCONNECT (512)
Autorisation de déconnecter une session.
AutorisationsDenied
-
Type de données : uint32
-
Type d'accès : Lecture seule
Spécifie les autorisations spécifiques à l’hôte de session Bureau à distance qui ne sont pas autorisées pour le compte. La valeur de cette propriété est un masque de bits, qui peut être défini sur une ou plusieurs des valeurs de la propriété PermissionsAllowed .
WINSTATION_QUERY=0x1 (0)
WINSTATION_SET=0x2 (1)
WINSTATION_LOGOFF=0x4 (2)
WINSTATION_VIRTUAL | STANDARD_RIGHTS_REQUIRED = 0xF008 (3)
WINSTATION_SHADOW=0x10 (4)
WINSTATION_LOGON=0x20 (5)
WINSTATION_MSG=0x80 (6)
WINSTATION_CONNECT=0x100 (7)
WINSTATION_DISCONNECT=0x200 (8)
SID
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Spécifie les identificateurs de sécurité du compte.
É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 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.
Cette propriété est héritée de CIM_ManagedSystemElement.
(« OK »)
(« Erreur »)
(« Dégradé »)
(« 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
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 Visual Basic et les appels de script, il s’agit d’un niveau d’authentification WbemAuthenticationLevelPktPrivacy ou « pktPrivacy », avec la valeur 6. L’exemple suivant de Visual Basic Scripting Edition (VBScript) 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 |
|