Win32_MappedLogicalDisk 类

项目
06/12/2023

Win32_MappedLogicalDiskWMI 类表示在计算机系统上映射为逻辑磁盘的网络存储设备。

以下语法从托管对象格式 (MOF) 代码中简化，包括所有继承的属性。属性和方法按字母顺序排列，而不是按 MOF 顺序排列。

语法

[Dynamic, Provider("CIMWin32"), UUID("{BCF02FFE-5560-4de2-B419-272918693426}"), AMENDMENT]
class Win32_MappedLogicalDisk : CIM_LogicalDisk
{
  uint16   Access;
  uint16   Availability;
  uint64   BlockSize;
  string   Caption;
  boolean  Compressed;
  uint32   ConfigManagerErrorCode;
  boolean  ConfigManagerUserConfig;
  string   CreationClassName;
  string   Description;
  string   DeviceID;
  boolean  ErrorCleared;
  string   ErrorDescription;
  string   ErrorMethodology;
  string   FileSystem;
  uint64   FreeSpace;
  datetime InstallDate;
  uint32   LastErrorCode;
  uint32   MaximumComponentLength;
  string   Name;
  uint64   NumberOfBlocks;
  string   PNPDeviceID;
  uint16   PowerManagementCapabilities[];
  boolean  PowerManagementSupported;
  string   ProviderName;
  string   Purpose;
  boolean  QuotasDisabled;
  boolean  QuotasIncomplete;
  boolean  QuotasRebuilding;
  string   SessionID;
  uint64   Size;
  string   Status;
  uint16   StatusInfo;
  boolean  SupportsDiskQuotas;
  boolean  SupportsFileBasedCompression;
  string   SystemCreationClassName;
  string   SystemName;
  string   VolumeName;
  string   VolumeSerialNumber;
};

成员

Win32_MappedLogicalDisk 类具有以下类型的成员：

方法
属性

方法

Win32_MappedLogicalDisk 类具有这些方法。

方法	说明
重置	未实现。若要实现此方法，请参阅 CIM_LogicalDisk 中的 Reset 方法。
SetPowerState	未实现。若要实现此方法，请参阅 CIM_LogicalDisk 中的 SetPowerState 方法。

属性

Win32_MappedLogicalDisk 类具有这些属性。

访问

数据类型： uint16
访问类型：只读

设备访问状态。

此属性继承自 CIM_StorageExtent。

未知 (0)

可读 (1)

可写 (2)

支持读/写 (3)

写入一次 (4)

可用性

数据类型： uint16
访问类型：只读
限定符： MappingStrings (“MIF”。DMTF |操作状态|003.5“，”MIB。IETF |HOST-RESOURCES-MIB.hrDeviceStatus“)

设备的可用性和状态。

此属性继承自 CIM_LogicalDevice。

其他 (1)

未知 (2)

运行/全功率 (3)

运行或全功率

警告 (4)

在测试 (5)

不适用 (6)

关机 (7)

下线 (8)

Offline

下班 (9)

降级 (10)

未安装 (11)

安装错误 (12)

节能 - 未知 (13)

已知设备处于节能模式，但其确切状态未知。

节能 - 低功耗模式 (14)

设备处于省电状态，但仍可正常运行，性能可能会下降。

节能 - 待机 (15)

设备无法正常工作，但可以快速通电。

Power Cycle (16)

节能 - 警告 (17)

设备处于警告状态，但也处于省电模式。

暂停 (18)

设备已暂停。

未就绪 (19)

设备未准备就绪。

未配置 (20)

设备未配置。

静止 (21)

设备安静。

BlockSize

数据类型： uint64
访问类型：只读
限定符： MappingStrings (“MIB”。IETF |HOST-RESOURCES-MIB.hrStorageAllocationUnits“) ， Units (”bytes“)

构成此存储区的块的大小（以字节为单位）。如果此概念对设备类型无效，则值为 1。

此属性继承自 CIM_StorageExtent。

有关在脚本中使用 uint64 值的详细信息，请参阅 WMI 中的脚本。

Caption

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

对象的简短说明。

此属性继承自 CIM_ManagedSystemElement。

Compressed

数据类型： 布尔值
访问类型：只读
限定符： MappingStrings (“Win32API|文件系统函数 |GetVolumeInformation |FS_VOL_IS_COMPRESSED“)

如果 为 True，则压缩该文件。

ConfigManagerErrorCode

数据类型： uint32
访问类型：只读
限定符：架构 (“Win32”)

Windows Configuration Manager错误代码。

此属性继承自 CIM_LogicalDevice。

此设备正常工作。 (0)

设备工作正常。

此设备未正确配置。 (1)

设备配置不正确。

Windows 无法为此设备加载驱动程序。 (2)

此设备的驱动程序可能已损坏，或者系统内存或其他资源不足。 (3)

此设备的驱动程序可能已损坏，或者系统内存或其他资源可能不足。

此设备无法正常工作。其中一个驱动程序或注册表可能已损坏。 (4)

设备无法正常工作。其中一个驱动程序或注册表可能已损坏。

此设备的驱动程序需要 Windows 无法管理的资源。 (5)

设备的驱动程序需要 Windows 无法管理的资源。

此设备的启动配置与其他设备冲突。 (6)

设备的启动配置与其他设备冲突。

无法筛选。 (7)

缺少设备的驱动程序加载程序。 (8)

缺少设备的驱动程序加载程序。

此设备无法正常工作，因为控制固件错误地报告了设备的资源。 (9)

设备无法正常工作。控制固件错误地报告了设备的资源。

此设备无法启动。 (10)

设备无法启动。

此设备失败。 (11)

设备失败。

此设备找不到可以使用的足够可用资源。 (12)

设备找不到足够的可用资源来使用。

Windows 无法验证此设备的资源。 (13)

Windows 无法验证设备的资源。

在重启计算机之前，此设备无法正常工作。 (14)

在重启计算机之前，设备无法正常工作。

此设备无法正常工作，因为可能存在重新枚举问题。 (15)

由于可能存在重新枚举问题，设备无法正常工作。

Windows 无法识别此设备使用的所有资源。 (16)

Windows 无法识别设备使用的所有资源。

此设备请求未知资源类型。 (17)

设备正在请求未知资源类型。

重新安装此设备的驱动程序。 (18)

必须重新安装设备驱动程序。

使用 VxD 加载程序失败。 (19)

注册表可能已损坏。 (20)

注册表可能已损坏。

系统故障：尝试更改此设备的驱动程序。如果这不起作用，请参阅硬件文档。Windows 正在删除此设备。 (21)

系统故障。如果更改设备驱动程序无效，请参阅硬件文档。 Windows 正在删除设备。

此设备已禁用。 (22)

设备已禁用。

系统故障：尝试更改此设备的驱动程序。如果这不起作用，请参阅硬件文档。 (23)

系统故障。如果更改设备驱动程序无效，请参阅硬件文档。

此设备不存在、未正常工作或未安装其所有驱动程序。 (24)

设备不存在、工作不正常或未安装其所有驱动程序。

Windows 仍在设置此设备。 (25)

Windows 仍在设置设备。

Windows 仍在设置此设备。 (26)

Windows 仍在设置设备。

此设备没有有效的日志配置。 (27)

设备没有有效的日志配置。

未安装此设备的驱动程序。 (28)

未安装设备驱动程序。

此设备处于禁用状态，因为设备的固件未为其提供所需的资源。 (29)

设备已禁用。设备固件未提供所需的资源。

此设备使用另一个设备正在使用的中断请求 (IRQ) 资源。 (30)

设备正在使用另一个设备正在使用的 IRQ 资源。

此设备无法正常工作，因为 Windows 无法加载此设备所需的驱动程序。 (31)

设备无法正常工作。 Windows 无法加载所需的设备驱动程序。

ConfigManagerUserConfig

数据类型： 布尔值
访问类型：只读
限定符：架构 (“Win32”)

如果 为 True，则设备正在使用用户定义的配置。

此属性继承自 CIM_LogicalDevice。

CreationClassName

数据类型： string
访问类型：只读
限定符： CIM_Key

在创建实例时使用的继承链中显示的第一个具体类的名称。与类的其他键属性一起使用时，此属性允许对此类的所有实例及其子类进行唯一标识。

此属性继承自 CIM_LogicalDevice。

描述

数据类型： string
访问类型：只读
限定符： DisplayName (“Description”)

对象的说明。

此属性继承自 CIM_ManagedSystemElement。

DeviceID

数据类型： string
访问类型：只读
限定符：键、替代 (“DeviceId”) 、 MappingStrings (“WMI”)

内存数组的唯一标识符。

此属性继承自 CIM_LogicalDevice。

示例：“内存数组 1”

ErrorCleared

数据类型： 布尔值
访问类型：只读

如果 为 True，则现在清除 LastErrorCode 中报告的错误。

此属性继承自 CIM_LogicalDevice。

ErrorDescription

数据类型： string
访问类型：只读

有关 LastErrorCode 中记录的错误的详细信息，以及可以采取的任何纠正措施的信息。

此属性继承自 CIM_LogicalDevice。

ErrorMethodology

数据类型： 字符串
访问类型：只读

硬件使用的错误检查类型。

此属性继承自 CIM_StorageExtent。

文件

数据类型： 字符串
访问类型：只读
限定符： MappingStrings (“Win32API|文件系统函数GetVolumeInformation)

访问类型：只读

逻辑磁盘上的文件系统。

示例：“NTFS”

FreeSpace

数据类型： uint64
访问类型：只读
限定符：单位 (“bytes”)

逻辑磁盘上的可用空间。

此属性继承自 CIM_LogicalDisk。

有关在脚本中使用 uint64 值的详细信息，请参阅在 WMI 中编写脚本。

InstallDate

数据类型： datetime
访问类型：只读
限定符： MappingStrings (“MIF”。DMTF |ComponentID|001.5“) ， DisplayName (”安装日期“)

访问类型：只读

对象的安装日期和时间。此属性不需要值来指示已安装对象。

此属性继承自 CIM_ManagedSystemElement。

LastErrorCode

数据类型： uint32
访问类型：只读

逻辑设备报告的最后一个错误代码。

此属性继承自 CIM_LogicalDevice。

MaximumComponentLength

数据类型： uint32
访问类型：只读
限定符： MappingStrings (“Win32API|文件系统函数GetVolumeInformation)

包含 Windows 驱动器支持的文件名组件的最大长度。

示例：255

名称

数据类型： 字符串
访问类型：只读
限定符： DisplayName (“Name”)

对象标签。

此属性继承自 CIM_ManagedSystemElement。

NumberOfBlocks

数据类型： uint64
访问类型：只读
限定符： MappingStrings (“MIB”。IETF |HOST-RESOURCES-MIB.hrStorageSize“)

连续块的总数，每个块是 BlockSize 属性中包含的值的大小，构成此存储区。存储区的总大小可以通过将 BlockSize 属性的值乘以此属性的值来计算。如果 BlockSize 的值为 1，则此属性是存储区的总大小。

此属性继承自 CIM_StorageExtent。

有关在脚本中使用 uint64 值的详细信息，请参阅在 WMI 中编写脚本。

PNPDeviceID

数据类型： 字符串
访问类型：只读
限定符：架构 (“Win32”)

Windows 即插即用逻辑设备的设备标识符。

此属性继承自 CIM_LogicalDevice。

示例：“*PNP030b”

PowerManagementCapabilities

数据类型： uint16 数组
访问类型：只读

逻辑设备的特定电源相关功能的数组。

此属性继承自 CIM_LogicalDevice。

未知 (0)

不支持 (1)

禁用 (2)

已启用 (3)

电源管理功能当前已启用，但确切功能集未知或信息不可用。

自动进入节能模式 (4)

设备可以根据使用情况或其他条件更改其电源状态。

Power State Settable (5)

支持 SetPowerState 方法。此方法在父 CIM_LogicalDevice 类上找到，可以实现。有关详细信息，请参阅设计托管对象格式 (MOF) 类。

支持电源循环 (6)

可以在 PowerState 参数设置为 5 的情况下调用 SetPowerState 方法， (Power Cycle) 。

支持计时开机 (7)

支持计时Power-On

可以使用 PowerState 参数设置为 5 (Power Cycle) 和时间设置为开机的特定日期和时间或间隔来调用 SetPowerState 方法。

PowerManagementSupported

数据类型： 布尔值
访问类型：只读

如果 为 True，则设备可以进行电源管理 (可以置于挂起模式，依此) 。属性并不指示当前已启用电源管理功能，仅指示逻辑设备能够进行电源管理。

此属性继承自 CIM_LogicalDevice。

ProviderName

数据类型： 字符串
访问类型：只读
限定符： MappingStrings (“Win32API|Windows 网络函数 |WNetGetConnection“)

逻辑设备的网络路径名称。

用途

数据类型： 字符串
访问类型：只读

描述媒体及其用途的自由格式字符串。

此属性继承自 CIM_StorageExtent。

QuotasDisabled

数据类型： 布尔值
访问类型：只读

如果 为 True，则不为此卷启用配额管理。

QuotasIncomplete

数据类型： 布尔值
访问类型：只读

如果 为 True，则表示已使用配额管理，但已禁用。 “不完整”是指禁用配额管理后文件系统中留下的信息。

QuotasRebuilding

数据类型： 布尔值
访问类型：只读

如果 为 True，则文件系统正在设置配额管理。

SessionID

数据类型： 字符串
访问类型：只读
限定符：键

用户会话的 ID。用户可以使用本地登录名或终端会话进行连接。

大小

数据类型： uint64
访问类型：只读
限定符：单位 (“bytes”)

逻辑磁盘的大小。

有关在脚本中使用 uint64 值的详细信息，请参阅在 WMI 中编写脚本。

此属性继承自 CIM_LogicalDisk。

Status

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

对象的当前状态。可以定义各种操作和非操作状态。操作状态包括：“正常”、“降级”和“Pred Fail” (元素，例如启用 SMART 的硬盘驱动器可能正常运行，但预测近期) 故障。非操作状态包括：“错误”、“正在启动”、“正在停止”和“服务”。服务状态适用于管理工作，例如磁盘镜像重新同步、重新加载用户权限列表或其他管理工作。并非所有此类工作都联机，但托管元素既不是“正常”，也不是处于其他状态之一。

此属性继承自 CIM_ManagedSystemElement。

有效值为：

OK (“OK”)

错误 (“错误”)

降级 (“已降级”)

未知 (“未知”)

Pred Fail (“Pred Fail”)

starting (“Starting”)

停止 (“停止”)

服务 (“服务”)

压力 (“有压力”)

NonRecover (“NonRecover”)

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

Lost Comm (“Lost Comm”)

StatusInfo

数据类型： uint16
访问类型：只读
限定符： MappingStrings (“MIF”。DMTF |操作状态|003.3“)

逻辑设备的状态。如果此属性不适用于逻辑设备，则应使用值 5 (不适用) 。

此属性继承自 CIM_LogicalDevice。

其他 (1)

未知 (2)

已启用 (3)

禁用 (4)

不适用 (5)

SupportsDiskQuotas

数据类型： 布尔值
访问类型：只读

如果 为 True，则映射此网络驱动器的文件系统支持磁盘配额。

SupportsFileBasedCompression

数据类型： 布尔值
访问类型：只读
限定符： MappingStrings (“Win32API|文件系统函数 |GetVolumeInformation |FS_FILE_COMPRESSION“)

如果 为 True，则逻辑磁盘分区支持基于文件的压缩，例如 NTFS 的情况。当 Compressed 属性为 True 时，此属性为 False。

SystemCreationClassName

数据类型： 字符串
访问类型：只读
限定符：传播 (“CIM_System。CreationClassName“) ， CIM_Key

范围计算机的 CreationClassName 属性的值。

此属性继承自 CIM_LogicalDevice。

SystemName

数据类型： 字符串
访问类型：只读
限定符：传播 (“CIM_System。Name“) ， CIM_Key

范围系统的名称。

此属性继承自 CIM_LogicalDevice。

VolumeName

数据类型： 字符串
访问类型：读/写
限定符： MappingStrings (“Win32API|文件系统函数GetVolumeInformation)

逻辑磁盘的卷名称。此属性值最多可以包含 32 个字符。

VolumeSerialNumber

数据类型： 字符串
访问类型：只读
限定符： MappingStrings (“Win32API|文件系统函数GetVolumeInformation)

逻辑磁盘的卷序列号。此属性值最多可以包含 11 个字符。

此属性继承自 CIM_LogicalDevice。

示例：“A8C3-D032”

备注

为此类返回的实例如下所示，假设用户 A 正在枚举实例：

提供程序在该计算机上查找用户 A 的登录会话：
- 如果有一个 (，并且只有一个) 此类登录会话，则提供程序将返回该会话的映射驱动器。
- 如果计算机上用户 A 有多个会话，则不会 (返回映射的驱动器实例，因为提供程序没有合理的方法来决定) 使用哪个会话。
如果没有运行用户 A 的会话，并且有一个本地登录的用户 B：
- 如果用户 B 有一个会话，则提供程序模拟 A 并返回用户 B 的映射驱动器。此案例支持支持人员想要查看本地登录用户的实例的方案。但是，是否返回实例取决于控制面板管理工具中的本地安全策略设置。如果以下策略设置为“Object Creator”，则不会返回映射的驱动器实例，即使 A 是 Administrators 组的成员：
  
  “系统对象：管理员组成员创建的对象的默认所有者。”
- 同样，如果计算机上运行了多个用户 B 会话，则提供程序无法决定使用哪个会话。在这种情况下，不会返回映射的驱动器实例。

有关使用 Win32_MappedLogicalDisk 的详细信息，请参阅如何确定哪些驱动器映射到网络共享？

示例

以下 PowerShell 代码片段显示了映射的驱动器。

Get-WmiObject Win32_MappedLogicalDisk | Select Name, ProviderName, FileSystem, Size, FreeSpace | Format-Table

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
命名空间	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

另请参阅

CIM_LogicalDisk
计算机系统硬件类
WMI 任务：磁盘和文件系统

Win32_MappedLogicalDisk 类

语法

成员

方法

属性

备注

示例

要求

另请参阅

反馈

反馈

其他资源