Win32_Group類別

Win32_Group WMI 類別代表群組帳戶的相關數據。 群組帳戶可針對使用者清單變更訪問許可權。 範例：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 類別具有這些屬性。

標題

數據類型： 字串

存取類型：唯讀

限定符： MaxLen （64）， DisplayName （“Caption”）

對象的簡短文字描述。

此屬性繼承自 CIM_ManagedSystemElement。

說明

數據類型： 字串

存取類型：唯讀

限定符： DisplayName （“Description”）

物件的文字描述。

此屬性繼承自 CIM_ManagedSystemElement。

網域

數據類型： 字串

存取類型：唯讀

限定符：覆寫 （“網域”），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“）

這個類別之 Domain 屬性所指定之網域上的 Windows 組帳戶名稱。

SID

數據類型： 字串

存取類型：唯讀

限定符：Fixed、MappingStrings （“Win32API|安全性識別碼（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）

狀態

數據類型： 字串

存取類型：唯讀

限定符： MaxLen （10）， DisplayName （“Status”）

表示物件目前狀態的字串。 您可以定義操作和非操作狀態。 作業狀態可以包含 「確定」、「已降級」和「預先失敗」。 「預先失敗」表示元素正常運作，但正在預測失敗（例如，已啟用SMART的硬碟驅動器）。

非作業狀態可能包括「錯誤」、「啟動」、「停止」和「服務」。 「服務」可以在磁碟鏡像重新Silvering、重載用戶權力清單或其他系統管理工作期間套用。 並非所有這類工作都在在線，但 Managed 元素既不是「確定」，也不是在其他其中一個狀態中。

此屬性繼承自 CIM_ManagedSystemElement。

包括下列值：

確定 （“OK”）

錯誤 （「錯誤」

已降級 （「已降級」

未知 （“未知”）

Pred Fail （“Pred Fail”）

啟動 （“開始”）

停止 （“停止”）

服務 （“Service”）

壓力（“壓力”）

NonRecover （“NonRecover”）

無連絡人 （“無聯繫人”）

Lost Comm （“Lost Comm”）

備註

Win32_Group類別衍生自 Win32_Account。

範例

下列程式代碼會使用 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
Namespace	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

另請參閱

Win32_Account

作業系統類別