Win32_Share 類別的 Create 方法

  • 發行項

建立 WMI 類別 方法會起始伺服器資源的共用。

本主題使用 Managed 物件格式 （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
);

參數

路徑 [in]

Windows 共用的本機路徑。

範例：「C：\Program Files」。

名稱 [in]

將別名傳遞至在執行 Windows 的電腦系統上設定為共用的路徑。

範例「public」。

輸入 [in]

傳遞要共用的資源類型。 類型包括磁片磁碟機、列印佇列、處理序間通訊（IPC）和一般裝置。 可以是下列其中一個值。

磁片磁碟機 （0）

列印佇列 （1）

裝置 （2）

IPC （3）

磁片磁碟機管理員 （2147483648）

列印佇列管理員 （2147483649）

裝置管理員 （2147483650）

IPC 管理員 （2147483651）

MaximumAllowed [in， optional]

限制允許同時使用此資源的使用者數目上限。

範例：10。 這是選擇性參數。

描述 [in， 選擇性]

描述所共用資源的選擇性批註。 這是選擇性參數。

密碼 [in， 選擇性]

密碼 （當伺服器以共用層級安全性執行時）共用資源。 如果伺服器是以使用者層級安全性執行，則會忽略此參數。 這是選擇性參數。

Access [in， optional]

使用者層級許可權的安全性描述元。 安全性描述項包含資源許可權、擁有者和存取功能的相關資訊。 如果未提供此參數或為 Null ，則每個人都具有共用的讀取權限。 如需詳細資訊，請參閱 Win32_SecurityDescriptor 和 變更安全性安全性的安全性安全性。

傳回值

傳回下列清單中所列的其中一個值，或任何其他值，以指出錯誤。 如需其他錯誤碼，請參閱 WMI 錯誤常數 或 WbemErrorEnum 。 如需一般 HRESULT 值，請參閱 系統錯誤碼 。

成功 （0）

拒絕 存取 （2）

未知的失敗 （8）

不正確名稱 （9）

不正確層級 （10）

不正確參數 （21）

重複共用 （22）

重新導向路徑 （23）

未知的裝置或目錄 （24）

找不到 淨名稱 （25）

其他 （26 4294967295）

備註

Create 是靜態方法。

只有管理員成員或帳戶操作員本機群組的成員，或是具有通訊、列印或伺服器操作員群組成員資格的成員，才能成功執行 Create 。 Print 運算子只能新增印表機佇列。 通訊操作員只能新增通訊裝置佇列。

範例

下列 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
Namespace
 Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

另請參閱

作業系統類別

Win32_Share