次の方法で共有


Win32_Share クラス

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

アクセスの種類: 読み取り専用

修飾子: keyOverride ("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 メソッドはすべてインスタンス メソッドです。

セキュリティのアクセス許可によっては、このクラスのすべてのプロパティを取得できない場合があります。 たとえば、 AllowMaximumMaximumAllowedPathType の各プロパティは 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 タスク: ファイルとフォルダー