Win32_Share クラスの Create メソッド

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

WMI クラスの作成メソッドは、サーバーリソースの共有を開始します。

このトピックでは、マネージドオブジェクト形式 (MOF) 構文を使用します。このメソッドの使用方法の詳細については、「メソッドの呼び出し」を参照してください。

構文

uint32 Create(
  [in]           string                   Path,
  [in]           string                   Name,
  [in]           uint32                   Type,
  [in, optional] uint32                   MaximumAllowed,
  [in, optional] string                   Description,
  [in, optional] string                   Password,
  [in, optional] Win32_SecurityDescriptor Access
);

パラメーター

Path [in]

Windows 共有のローカルパス。

例: "C:\Program Files"。

Name [in]

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

たとえば、"public" です。

「in」と入力します

共有するリソースの種類を渡します。種類には、ディスクドライブ、印刷キュー、プロセス間通信 (IPC)、および一般的なデバイスが含まれます。次のいずれかの値を指定できます。

ディスクドライブ (0)

印刷キュー (1)

デバイス (2)

IPC (3)

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

印刷キュー管理 (2147483649)

デバイス管理 (2147483650)

IPC 管理 (2147483651)

MaximumAllowed [in, optional]

このリソースを同時に使用できるユーザーの最大数に制限します。

例: 10。このパラメーターは省略可能です。

説明 [in, optional]

共有されているリソースを説明するオプションのコメント。このパラメーターは省略可能です。

Password [in, optional]

共有リソースのパスワード (サーバーが共有レベルのセキュリティで実行されている場合)。サーバーがユーザーレベルのセキュリティで実行されている場合、このパラメーターは無視されます。このパラメーターは省略可能です。

Access [in, optional]

ユーザーレベルのアクセス許可のセキュリティ記述子。セキュリティ記述子には、リソースのアクセス許可、所有者、およびアクセス機能に関する情報が含まれています。このパラメーターが指定されていない場合、または NULL の場合、Everyone は共有への読み取りアクセス権を持ちます。詳細については、「セキュリティ保護可能なオブジェクトのWin32_SecurityDescriptorとアクセスセキュリティの変更」を参照してください。

戻り値

次の一覧に記載されている値の 1 つ、またはエラーを示すその他の値を返します。その他のエラーコードについては、「 WMI エラー定数」 または 「WbemErrorEnum」を参照してください。一般的な HRESULT 値については、「システムエラーコード」を参照してください。

成功 (0)
アクセスが拒否されました (2)
不明なエラー (8)
無効な名前 (9)
無効なレベル (10)
パラメーターが無効です (21)
重複する共有 (22)
リダイレクトされたパス (23)
不明なデバイスまたはディレクトリ (24)
ネット名が見つかりません (25)
その他 (26 4294967295)

注釈

Create は静的メソッドです。

Create を正常 に実行できるのは、Administrators または Account Operators ローカルグループのメンバー、または Communication、Print、または Server オペレーターグループメンバーシップを持つメンバーのみです。 Print オペレーターは、プリンターキューのみを追加できます。 Communication オペレーターは、通信デバイスキューのみを追加できます。

例

ファイル共有のエクスポートとインポートの PowerShell サンプルでは、ファイル共有のエクスポートとインポートを行い、共有のアクセス許可を設定します。同様に、共有の作成とアクセス許可の設定のサンプルでも、新しい共有が作成され、共有のアクセス許可が設定されます。

次の PowerShell コードは、共有を作成します。

# create pointer to class
$comp=[WMICLASS]"Win32_share"

# create a new share
$comp.create("c:\","mynewshare",0)

# see results
gwmi win32_share

前のコードサンプルでは、次が返されます。

__GENUS          : 2
__CLASS          : __PARAMETERS
__SUPERCLASS     : 
__DYNASTY        : __PARAMETERS
__RELPATH        : 
__PROPERTY_COUNT : 1
__DERIVATION     : {}
__SERVER         : 
__NAMESPACE      : 
__PATH           : 
ReturnValue      : 2
PSComputerName   : 

Name        : ADMIN$
Path        : C:\Windows
Description : Remote Admin

Name        : C$
Path        : C:\
Description : Default share

Name        : CCMLOGS$
Path        : C:\Windows\CCM\Logs
Description : Public Share

Name        : ccmsetup$
Path        : C:\Windows\ccmsetup
Description : Public Share

Name        : Drop
Path        : C:\Drop
Description : 

Name        : IPC$
Path        : 
Description : Remote IPC

Name        : Share
Path        : C:\Share
Description :

次の C# コードサンプルでは、create メソッドを呼び出す方法について説明します。

private static void makeShare(string servername, string filepath, string sharename)
{
try
 {
 // assemble the string so the scope represents the remote server
 string scope = string.Format("\\\\{0}\\root\\cimv2", servername);

 // connect to WMI on the remote server
 ManagementScope ms = new ManagementScope(scope);

 // create a new instance of the Win32_Share WMI object
 ManagementClass cls = new ManagementClass("Win32_Share");

 // set the scope of the new instance to that created above
 cls.Scope = ms;

 // assemble the arguments to be passed to the Create method
 object[] methodargs = { filepath, sharename, "0" };

 // invoke the Create method to create the share
 object result = cls.InvokeMethod("Create", methodargs);
 }
catch (SystemException e)
 {
  Console.WriteLine("Error attempting to create share {0}:", sharename);
  Console.WriteLine(e.Message);
 }

}

要件

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

こちらもご覧ください

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

Share via

Win32_Share クラスの Create メソッド

構文

パラメーター

戻り値

注釈

例

要件

こちらもご覧ください

フィードバック

フィードバック

その他のリソース