Share via

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
CIMWin32.mof
[DLL]
CIMWin32.dll

こちらもご覧ください

Win32_Account

オペレーティング システム クラス