Win32_Group 类

项目
06/12/2023

Win32_GroupWMI 类表示有关组帐户的数据。组帐户允许更改用户列表的访问权限。示例：Marketing2。

以下语法从托管对象格式 (MOF) 代码中简化，包括所有继承的属性。属性按字母顺序列出，而不是按 MOF 顺序列出。

语法

[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;
};

成员

Win32_Group 类具有以下类型的成员：

方法
属性

方法

Win32_Group 类具有这些方法。

方法	说明
重命名	更改组名称。

属性

Win32_Group 类具有这些属性。

Caption

数据类型： 字符串
访问类型：只读
限定符： MaxLen (64) 、 DisplayName (“Caption”)

对象的简短文本说明。

此属性继承自 CIM_ManagedSystemElement。

描述

数据类型： 字符串
访问类型：只读
限定符： DisplayName (“Description”)

对象的文本说明。

此属性继承自 CIM_ManagedSystemElement。

Domain

数据类型： 字符串
访问类型：只读
限定符：重写 (“域”) ， MappingStrings (“Win32API|网络管理函数|domainname“)

组帐户所属的 Windows 域的名称。

示例：“NA-SALES”

InstallDate

数据类型： datetime
访问类型：只读
限定符： MappingStrings (“MIF”。DMTF |ComponentID|001.5“) ， DisplayName (”安装日期“)

指示对象的安装时间。缺少值并不表示未安装对象。

此属性继承自 CIM_ManagedSystemElement。

LocalAccount

数据类型： 布尔值
访问类型：只读
限定符： 已修复

如果 为 TRUE，则在本地计算机上定义帐户。若要仅检索在本地计算机上定义的帐户，请设计一个包含条件“LocalAccount=TRUE”的查询。

此属性继承自 Win32_Account。

名称

数据类型： 字符串
访问类型：只读
限定符：重写 (“Name”) ， MappingStrings (“Win32API|网络管理结构|name“)

此类的 域属性指定的 域上的 Windows 组帐户的名称。

SID

数据类型： 字符串
访问类型：只读
限定符： Fixed、 MappingStrings (“Win32API|安全标识符 (SID) “)

此帐户的安全标识符 (SID) 。 SID 是用于标识受信人的可变长度的字符串值。每个帐户都有一个唯一的 SID，该 SID 由颁发机构 (，例如存储在安全数据库中的 Windows 域) 。当用户登录时，系统会从数据库中检索用户的 SID，并将其置于用户的访问令牌中。系统使用用户的访问令牌中的 SID 在与 Windows 安全的所有后续交互中标识用户。当 SID 已用作用户或组的唯一标识符时，它不能再次用于标识其他用户或组。

此属性继承自 Win32_Account。

SIDType

数据类型： uint8
访问类型：只读
限定符：Fixed、MappingStrings (“Win32API|访问控制枚举类型 |SID_NAME_USE“)

指定 SID) 安全标识符类型的枚举值 (。

此属性继承自 Win32_Account。

SidTypeUser (1)

SidTypeGroup (2)

SidTypeDomain (3)

SidTypeAlias (4)

SidTypeWellKnownGroup (5)

SidTypeDeletedAccount (6)

SidTypeInvalid (7)

SidTypeUnknown (8)

SidTypeComputer (9)

Status

数据类型： 字符串
访问类型：只读
限定符： MaxLen (10) 、 DisplayName (“Status”)

指示对象的当前状态的字符串。可以定义操作状态和非操作状态。操作状态可能包括“正常”、“降级”和“预失败”。 “Pred Fail”表示某个元素正常运行，但预测故障 (例如启用 SMART 的硬盘驱动器) 。

非操作状态可能包括“错误”、“正在启动”、“正在停止”和“服务”。 “服务”可以在磁盘镜像重新同步、重新加载用户权限列表或其他管理工作期间应用。并非所有此类工作都联机，但托管元素既不是“正常”，也不是处于其他状态之一。

此属性继承自 CIM_ManagedSystemElement。

包括以下值：

OK (“OK”)

错误 (“错误”)

降级 (“已降级”)

未知 (“未知”)

Pred Fail (“Pred Fail”)

starting (“Starting”)

停止 (“停止”)

服务 (“服务”)

压力 (“有压力”)

NonRecover (“NonRecover”)

无联系人 (“无联系人”)

Lost Comm (“Lost Comm”)

备注

Win32_Group 类派生自 Win32_Account。

示例

以下代码取自 TechNet 库中的“使用 WMI VBScript 列出本地组 ”代码示例，使用 Win32_Group 返回有关在计算机上找到的本地组的信息。

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

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
命名空间	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

另请参阅

Win32_Account
操作系统类

通过

Win32_Group 类

语法

成员

方法

属性

备注

示例

要求

另请参阅

反馈

反馈

其他资源