classe Win32_Group

La classe WMIWin32_Group représente les données relatives à un compte de groupe. Un compte de groupe permet de modifier les privilèges d’accès pour une liste d’utilisateurs. Exemple : Marketing2.

La syntaxe suivante est simplifiée par rapport au code MOF (Managed Object Format) et inclut toutes les propriétés héritées. Les propriétés sont répertoriées dans l’ordre alphabétique, et non dans l’ordre MOF.

Syntaxe

[Dynamic, Provider("CIMWin32"), UUID("{8502C4CB-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_Group : Win32_Account
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Status;
  boolean  LocalAccount;
  string   SID;
  uint8    SIDType;
  string   Domain;
  string   Name;
};

Membres

La classe Win32_Group a les types de membres suivants :

• Méthodes
• Propriétés

Méthodes

La classe Win32_Group a ces méthodes.

Méthode	Description
Renommer	Modifie le nom du groupe.

Propriétés

La classe Win32_Group possède ces propriétés.

Caption

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (64), DisplayName (« Caption »)

Brève description textuelle 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

Qualificateurs : DisplayName (« Description »)

Description textuelle de l’objet.

Cette propriété est héritée de CIM_ManagedSystemElement.

Domaine

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Remplacer (« Domaine »), MappingStrings (« Win32API| Fonctions de gestion réseau|nom_domaine »)

Nom du domaine Windows auquel appartient le compte de groupe.

Exemple : « NA-SALES »

InstallDate

Type de données : datetime

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« MIF. DMTF| ComponentID|001.5 »), DisplayName (« Date d’installation »)

Indique quand 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.

LocalAccount

Type de données : booléen

Type d'accès : Lecture seule

Qualificateurs : corrigé

Si la valeur est TRUE, le compte est défini sur l’ordinateur local. Pour récupérer uniquement les comptes définis sur l’ordinateur local, concevez une requête qui inclut la condition « LocalAccount=TRUE ».

Cette propriété est héritée de Win32_Account.

Nom

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Remplacer (« Nom »), MappingStrings (« Win32API| Structures de gestion réseau|nom »)

Nom du compte de groupe Windows sur le domaine spécifié par la propriété Domain de cette classe.

SID

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Fixe, MappingStrings (« Win32API| Identificateurs de sécurité (SID) »)

Identificateur de sécurité (SID) pour ce compte. Un SID est une valeur de chaîne de longueur variable utilisée pour identifier un fiduciaire. Chaque compte a un SID unique émis par une autorité (par exemple, un domaine Windows), stocké dans une base de données de sécurité. Lorsqu’un utilisateur se connecte, le système récupère le SID de l’utilisateur à partir de la base de données et le place dans le jeton d’accès de l’utilisateur. Le système utilise le SID dans le jeton d’accès de l’utilisateur pour identifier l’utilisateur dans toutes les interactions suivantes avec la sécurité Windows. Lorsqu’un SID a été utilisé comme identificateur unique d’un utilisateur ou d’un groupe, il ne peut pas être utilisé à nouveau pour identifier un autre utilisateur ou groupe.

Cette propriété est héritée de Win32_Account.

SIDType

Type de données : uint8

Type d'accès : Lecture seule

Qualificateurs : Fixe, MappingStrings (« Win32API|Access Control Types d’énumération | SID_NAME_USE »)

Valeurs énumérées qui spécifient le type d’identificateur de sécurité (SID).

Cette propriété est héritée de Win32_Account.

SidTypeUser (1)

SidTypeGroup (2)

SidTypeDomain (3)

SidTypeAlias (4)

SidTypeWellKnownGroup (5)

SidTypeDeletedAccount (6)

SidTypeInvalid (7)

SidTypeUnknown (8)

SidTypeComputer (9)

État

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (10), DisplayName (« Status »)

Chaîne qui indique la status actuelle de l’objet. Il est possible de définir des status opérationnels et non opérationnels. Les status opérationnelles peuvent inclure « OK », « Détérioré » et « Échec anticipé ». « Échec anticipé » indique qu’un élément fonctionne correctement, mais qu’il prédit une défaillance (par exemple, un disque dur smart).

Les status non opérationnelles peuvent inclure « Error », « Starting », « Stopping » et « Service ». « Service » peut s’appliquer pendant la miroir 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.

Les valeurs sont notamment les suivantes :

OK (« OK »)

Erreur (« Erreur »)

Dégradé (« Dégradé »)

Inconnu (« Inconnu »)

Échec de la préversion (« Échec prédé »)

Démarrage (« Démarrage »)

Arrêt (« Arrêt »)

Service (« Service »)

Stressé (« Stressé »)

NonRecover (« NonRecover »)

Aucun contact (« Aucun contact »)

Lost Comm (« Lost Comm »)

Notes

La classe Win32_Group est dérivée de Win32_Account.

Exemples

Le code suivant, extrait de l’exemple de code List Local Groups Using WMI VBScript sur TechNet Gallery, utilise Win32_Group pour renvoyer des informations sur les groupes locaux trouvés sur un ordinateur.

On Error Resume Next 
 
strComputer = "." 
Set objWMIService = GetObject("winmgmts:" _ 
    & "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2") 
Set colItems = objWMIService.ExecQuery _ 
    ("Select * from Win32_Group  Where LocalAccount = True") 
 
For Each objItem in colItems 
    Wscript.Echo "Caption: " & objItem.Caption 
    Wscript.Echo "Description: " & objItem.Description 
    Wscript.Echo "Domain: " & objItem.Domain 
    Wscript.Echo "Local Account: " & objItem.LocalAccount 
    Wscript.Echo "Name: " & objItem.Name 
    Wscript.Echo "SID: " & objItem.SID 
    Wscript.Echo "SID Type: " & objItem.SIDType 
    Wscript.Echo "Status: " & objItem.Status 
    Wscript.Echo 
Next 

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

Voir aussi

Win32_Account

Classes du système d’exploitation