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 |
|
| DLL |
|