Win32_TSAccount classe

  • Article

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
TSCfgWmi.mof
DLL
TSCfgWmi.dll

Voir aussi

Win32_TerminalSetting