Win32_Share クラス

[アーティクル]
06/12/2023

Win32_Share クラスは、Windows を実行しているコンピューターシステム上の共有リソースを表します。ディスクドライブ、プリンター、プロセス間通信、またはその他の共有可能なデバイスを使用できます。 WMI クラスの取得の詳細については、「クラスの取得」を参照してください。

次の構文はマネージドオブジェクトフォーマット (MOF) のコードを単純化したもので、すべての継承されたプロパティを含みます。プロパティとメソッドは、MOF の順序ではなく、アルファベット順です。

構文

[Dynamic, Provider("CIMWin32"), UUID("{8502C4D6-5FBB-11D2-AAC1-006008C78BC7}"), SupportsCreate, CreateBy("Create"), SupportsDelete, DeleteBy("DeleteInstance"), AMENDMENT]
class Win32_Share : CIM_LogicalElement
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Status;
  uint32   AccessMask;
  boolean  AllowMaximum;
  uint32   MaximumAllowed;
  string   Name;
  string   Path;
  uint32   Type;
};

メンバー

Win32_Share クラスには、次の種類のメンバーがあります。

メソッド
プロパティ

メソッド

Win32_Share クラスには、これらのメソッドがあります。

メソッド	説明
作成	サーバーリソースの共有を開始するクラスメソッド。
削除	サーバーの共有リソースの一覧から共有名を削除し、共有リソースへの接続を切断するクラスメソッド。
GetAccessMask	インスタンスに代わって返されるユーザーまたはグループが保持している共有へのアクセス権を返します。このメソッドは、 AccessMask プロパティ (常に NULL) の代わりに使用する必要があります。
SetShareInfo	共有リソースのパラメーターを設定するクラスメソッド。

プロパティ

Win32_Share クラスには、これらのプロパティがあります。

AccessMask

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: 非推奨

このプロパティは古く、使用されなくなりました。代わりに 、Win32_Share.GetAccessMask メソッドを使用してください。 AccessMask プロパティの値は、WMI によって null に設定されます。共有の作成時にアクセスを設定する方法の詳細については、 Create メソッドを参照してください。

AllowMaximum

データ型: boolean
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|ネットワーク管理構造|SHARE_INFO_502|shi502_max_uses")

このリソースの同時ユーザーの数が制限されています。 True の場合、MaximumAllowed プロパティの値は無視されます。

Caption

データ型: string
アクセスの種類: 読み取り専用
修飾子: MaxLen (64)、 DisplayName ("Caption")

オブジェクトの短いテキスト説明。

このプロパティは 、CIM_ManagedSystemElementから継承されます。

説明

データ型: string
アクセスの種類: 読み取り専用
修飾子: DisplayName ("Description")

オブジェクトのテキスト説明。

このプロパティは 、CIM_ManagedSystemElementから継承されます。

InstallDate

データ型: datetime
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("MIF.DMTF|ComponentID|001.5"), DisplayName ("インストール日")

オブジェクトがインストールされたタイミングを示します。値がない場合、オブジェクトがインストールされていないことを示すわけではありません。

このプロパティは 、CIM_ManagedSystemElementから継承されます。

MaximumAllowed

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|ネットワーク管理構造|SHARE_INFO_502|shi502_max_uses")

このリソースを同時に使用できるユーザーの最大数に制限します。この値は、 AllowMaximum プロパティが FALSE に設定されている場合にのみ有効です。

名前

データ型: string
アクセスの種類: 読み取り専用
修飾子: key、 Override ("Name")、 MappingStrings ("Win32API|ネットワーク管理構造|SHARE_INFO_1|shi1_netname")

Windows を実行しているコンピューターシステム上の共有として設定されたパスに指定されたエイリアス。

Windows 2008 の例: "\SERVER01\public" - Windows Server 2008 では、名前に UNC を配置する必要があります。

パス

データ型: string
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|ネットワーク管理構造|SHARE_INFO_502|shi502_path")

Windows 共有のローカルパス。

例: "C:\Program Files"

状態

データ型: string
アクセスの種類: 読み取り専用
修飾子: MaxLen (10)、 DisplayName ("Status")

オブジェクトの現在の状態を示す文字列。操作状態と非運用状態を定義できます。運用状態には、"OK"、"機能低下"、"Pred Fail" を含めることができます。 "Pred Fail" は、要素が正しく機能しているが、エラー (SMART 対応ハードディスクドライブなど) を予測していることを示します。

非運用状態には、"エラー"、"開始中"、"停止中"、および "サービス" が含まれる場合があります。 "サービス" は、ディスクミラー再チェックイン、ユーザーアクセス許可リストの再読み込み、またはその他の管理作業中に適用できます。このような作業のすべてがオンラインであるわけではありませんが、マネージド要素は "OK" でも、他の状態の 1 つでもありません。

このプロパティは 、CIM_ManagedSystemElementから継承されます。

次の値があります。

OK ("OK")

エラー ("Error")

機能低下 ("Degraded")

不明 ("不明")

Pred Fail ("Pred Fail")

開始中 ("Starting")

停止中 ("停止中")

サービス ("Service")

ストレス ( "ストレス")

NonRecover ("NonRecover")

連絡先なし ("連絡先なし")

Lost Comm ("Lost Comm")

Type

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|ネットワーク管理構造|SHARE_INFO_502|shi502_type")

共有されているリソースの種類。種類には、ディスクドライブ、印刷キュー、プロセス間通信 (IPC)、および一般的なデバイスが含まれます。

ディスクドライブ (0)

印刷キュー (1)

デバイス (2)

IPC (3)

ディスクドライブの管理 (2147483648)

印刷キュー管理 (2147483649)

デバイス管理 (2147483650)

IPC 管理 (2147483651)

注釈

Win32_Share クラスは、CIM_LogicalElementから派生します。

このクラスの Create メソッドは静的メソッドです。 Delete メソッド、GetAccessMask メソッド、および SetShareInfo メソッドはすべてインスタンスメソッドです。

セキュリティのアクセス許可によっては、このクラスのすべてのプロパティを取得できない場合があります。たとえば、 AllowMaximum、 MaximumAllowed、 Path、 Type の各プロパティは null を返す場合があります。一般に、Power Users と管理者はすべてのプロパティ値を取得できます。

例

次のスクリプトセンターのコード例では、コンピューター上のすべての共有を一覧表示し、各共有のすべての共有アクセス許可を一覧表示します。

Win32_Share PowerShell サンプルクエリと同様の共有情報の取得 Win32_Shareし、結果を提供します。

次の PowerShell サンプルでは、ローカルシステム上の共有を表示します。

$shares = Get-WMIObject -class Win32_share
"Shares on : {0}" -f $((gwmi win32_computersystem).name)
$shares | sort name | ft -auto

または、より正確にフィルター処理する場合は、次の PowerShell スニペットを使用できます。

gwmi -q "SELECT * FROM Win32_Share WHERE Name != 'ADMIN$' AND Name != 'IPC$'"

次の VBScript サンプルでは、ローカルシステム上の共有を表示します。

strComputer = "." 
Set objWMIService = GetObject("winmgmts:\\" & strComputer & "\root\CIMV2") 
Set colItems = objWMIService.ExecQuery("SELECT * FROM Win32_Share")


For Each objItem in colItems 
 Wscript.Echo "Name: " & objItem.Name
 Wscript.Echo "Caption: " & objItem.Caption & "=" & objItem.Path
Next

要件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
名前空間	Root\CIMV2
MOF	CIMWin32.mof
[DLL]	CIMWin32.dll

こちらもご覧ください

CIM_LogicalElement
オペレーティングシステムクラス
WMI タスク: ファイルとフォルダー

次の方法で共有

Win32_Share クラス

構文

メンバー

メソッド

プロパティ

注釈

例

要件

こちらもご覧ください

フィードバック

その他のリソース