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

名称

数据类型: 字符串

访问类型:只读

限定符: 重写 (“名称”) , MappingStrings (“Win32API|网络管理结构|name“)

此类的 Domain 属性所指定的域中的Windows组帐户的名称。

SID

数据类型: 字符串

访问类型:只读

限定符: 固定映射 字符串 (“Win32API|安全标识符 (SID) “)

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

此属性继承自 Win32_Account

SIDType

数据类型: uint8

访问类型:只读

限定符:固定映射字符串 (“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”。 “Pred Fail”表示元素正常运行,但预测故障 (例如启用了 SMART 的硬盘驱动器) 。

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

此属性继承自 CIM_ManagedSystemElement

包括以下值:

确定 (“确定”)

错误 (“错误”)

降级 (“已降级”)

未知 (“未知”)

Pred Fail (“Pred Fail”)

启动 (“启动”)

停止 (“停止”)

服务 (“服务”)

压力 (“压力”)

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

操作系统类