Win32_Share 类

项目
06/12/2023

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 方法。 WMI 将 AccessMask 属性的值设置为 null。有关在创建共享时设置访问权限的详细信息，请参阅 Create 方法。

AllowMaximum

数据类型： 布尔值
访问类型：只读
限定符： MappingStrings (“Win32API|网络管理结构 |SHARE_INFO_502|shi502_max_uses“)

此资源的并发用户数已受到限制。如果 为 True，则忽略 MaximumAllowed 属性中的值。

Caption

数据类型： 字符串
访问类型：只读
限定符： MaxLen (64) 、 DisplayName (“Caption”)

对象的简短文本说明。

此属性继承自 CIM_ManagedSystemElement。

描述

数据类型： 字符串
访问类型：只读
限定符： 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 时，该值才有效。

名称

数据类型： 字符串
访问类型：只读
限定符：键、重写 (“Name”) 、 MappingStrings (“Win32API|网络管理结构 |SHARE_INFO_1|shi1_netname“)

为在运行 Windows 的计算机系统上设置为共享的路径提供别名。

Windows 2008 示例：“\SERVER01\public” - Windows Server 2008 要求将 UNC 放在名称中。

路径

数据类型： 字符串
访问类型：只读
限定符： MappingStrings (“Win32API|网络管理结构 |SHARE_INFO_502|shi502_path“)

Windows 共享的本地路径。

示例：“C：\Program Files”

Status

数据类型： 字符串
访问类型：只读
限定符： MaxLen (10) 、 DisplayName (“Status”)

指示对象的当前状态的字符串。可以定义操作状态和非操作状态。操作状态可能包括“正常”、“降级”和“预失败”。 “Pred Fail”表示某个元素正常运行，但预测故障 (例如启用 SMART 的硬盘驱动器) 。

非操作状态可能包括“错误”、“正在启动”、“正在停止”和“服务”。 “服务”可以在磁盘镜像重新同步、重新加载用户权限列表或其他管理工作期间应用。并非所有此类工作都联机，但托管元素既不是“正常”，也不是处于其他状态之一。

此属性继承自 CIM_ManagedSystemElement。

包括以下值：

OK (“OK”)

错误 (“错误”)

降级 (“已降级”)

未知 (“未知”)

Pred Fail (“Pred Fail”)

starting (“Starting”)

停止 (“停止”)

服务 (“服务”)

压力 (“有压力”)

NonRecover (“NonRecover”)

无联系人 (“无联系人”)

Lost Comm (“Lost Comm”)

类型

数据类型： 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 和 Administrators 将能够检索所有属性值。

示例

以下脚本中心代码示例列出了计算机上的所有共享，并列出了每个共享的所有共享权限。

获取共享信息类似于 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 任务：文件和文件夹

通过

Win32_Share 类

语法

成员

方法

属性

备注

示例

要求

另请参阅

反馈

其他资源