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
-
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MaxLen (64)、 DisplayName ("Caption")
オブジェクトの短いテキストの説明。
このプロパティは、 CIM_ManagedSystemElementから継承されます。
-
-
説明
-
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: DisplayName ("Description")
オブジェクトのテキストの説明。
このプロパティは、 CIM_ManagedSystemElementから継承されます。
-
-
ドメイン
-
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: オーバーライド ("Domain")、 MappingStrings ("Win32API|ネットワーク管理機能|domainname")
グループ アカウントが属する Windows ドメインの名前。
例: "NA-SALES"
-
-
InstallDate
-
-
データ型: datetime
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("MIF.DMTF|ComponentID|001.5"), DisplayName ("インストール日")
オブジェクトがインストールされた日時を示します。 値がない場合、オブジェクトがインストールされていないことを示すわけではありません。
このプロパティは、 CIM_ManagedSystemElementから継承されます。
-
-
LocalAccount
-
-
データ型: ブール値
-
アクセスの種類: 読み取り専用
-
修飾子: 修正済み
TRUE の場合、アカウントはローカル コンピューターで定義されます。 ローカル コンピューターで定義されているアカウントのみを取得するには、条件 "LocalAccount=TRUE" を含むクエリを設計します。
このプロパティは、 Win32_Accountから継承されます。
-
-
名前
-
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: オーバーライド ("Name")、 MappingStrings ("Win32API|ネットワーク管理構造|名前")
このクラスの Domain プロパティで指定されたドメイン上の Windows グループ アカウントの名前。
-
-
SID
-
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("Win32API| セキュリティ識別子 (SID)")
このアカウントのセキュリティ識別子 (SID)。 SID は、トラスティを識別するために使用される可変長の文字列値です。 各アカウントには、セキュリティ データベースに格納されている機関 (Windows ドメインなど) によって発行された一意の SID があります。 ユーザーがログオンすると、システムはデータベースからユーザーの SID を取得し、ユーザーのアクセス トークンに配置します。 システムは、ユーザーのアクセス トークンの SID を使用して、Windows セキュリティとの後続のすべての操作でユーザーを識別します。 SID がユーザーまたはグループの一意の識別子として使用されている場合、別のユーザーまたはグループを識別するために再び使用することはできません。
このプロパティは、 Win32_Accountから継承されます。
-
-
SIDType
-
-
データ型: uint8
-
アクセスの種類: 読み取り専用
-
修飾子: 修正済み、MappingStrings ("Win32API|Access Control列挙型|SID_NAME_USE")
セキュリティ識別子 (SID) の種類を指定する列挙値。
このプロパティは、 Win32_Accountから継承されます。
-
-
SidTypeUser (1)
-
SidTypeGroup (2)
-
SidTypeDomain (3)
-
SidTypeAlias (4)
-
SidTypeWellKnownGroup (5)
-
SidTypeDeletedAccount (6)
-
SidTypeInvalid (7)
-
SidTypeUnknown (8)
-
SidTypeComputer (9)
状態
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MaxLen (10)、 DisplayName ("Status")
オブジェクトの現在の状態を示す文字列。 運用状態と非運用状態を定義できます。 操作状態には、"OK"、"低下"、"事前失敗" が含まれます。 "Pred Fail" は、要素が正しく機能しているが、エラー (SMART 対応ハード ディスク ドライブなど) を予測していることを示します。
非運用状態には、"エラー"、"開始中"、"停止中"、"サービス" が含まれる場合があります。 "サービス" は、ディスクのミラー、ユーザーのアクセス許可リストの再読み込み、またはその他の管理作業中に適用できます。 このような作業のすべてがオンラインであるわけではありませんが、マネージド要素は "OK" でも、他の状態の 1 つでもありません。
このプロパティは、 CIM_ManagedSystemElementから継承されます。
次の値があります。
OK ("OK")
エラー ("Error")
機能低下 ("Degraded")
不明 ("不明")
Pred Fail ("Pred Fail")
開始 ("開始")
停止中 ("停止中")
サービス ("Service")
ストレス ( "ストレス")
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 |
|
[DLL] |
|