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
-
アクセスの種類: 読み取り専用
-
修飾子: 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 |
|
| [DLL] |
|
こちらもご覧ください
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示