Win32_Share 类的 Create 方法

  • 项目

CreateWMI 类方法启动服务器资源的共享。

本主题使用托管对象格式 (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”。

Name [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 示例导出和导入文件共享并设置共享权限。 同样， 创建共享和设置权限 示例也会创建新的共享并设置共享权限。

以下 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