Win32_Group 类

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

数据类型: 字符串

访问类型:只读

限定符: FixedMappingStrings (“Win32API|安全标识符 (SID) “)

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

此属性继承自 Win32_Account

SIDType

数据类型: uint8

访问类型:只读

限定符:FixedMappingStrings (“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

操作系统类