Поделиться через

Класс Win32_MappedLogicalDisk

  • Статья

Класс WMIWin32_MappedLogicalDisk представляет сетевые запоминающие устройства, сопоставленные как логические диски в компьютерной системе.

Следующий пример синтаксиса — упрощенный 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 содержит эти методы.

Метод Описание
Сброс Не реализован. Чтобы реализовать этот метод, см. метод Reset в CIM_LogicalDisk.
SetPowerState Не реализован. Чтобы реализовать этот метод, см. метод SetPowerState в CIM_LogicalDisk.

Свойства

Класс 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)

Off Line (8)

Автономная миграция

Off Duty (9)

Понижение производительности (10)

Не установлено (11)

Ошибка установки (12)

Power Save — неизвестно (13)

Известно, что устройство находится в режиме экономии энергии, но его точное состояние неизвестно.

Экономия энергии — режим низкого энергопотребления (14)

Устройство находится в состоянии экономии энергии, но по-прежнему работает и может демонстрировать снижение производительности.

Экономия энергии в режиме ожидания (15)

Устройство не работает, но может быть приведено в полную мощность быстро.

Цикл питания (16)

Экономия энергии — предупреждение (17)

Устройство находится в состоянии предупреждения, хотя и в режиме экономии энергии.

Приостановлено (18)

Устройство приостановлено.

Не готово (19)

Устройство не готово.

Не настроено (20)

Устройство не настроено.

Притормоенная (21)

Устройство работает тихо.

BlockSize

Тип данных: uint64

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("MIB. IETF| HOST-RESOURCES-MIB.hrStorageAllocationUnits), единицы измерения ("байты")

Размер (в байтах) блоков, образующих этот экстент хранилища. Если эта концепция не является допустимой для типа устройства, значение равно 1.

Это свойство наследуется от CIM_StorageExtent.

Дополнительные сведения об использовании значений uint64 в скриптах см. в разделе Скрипты в WMI.

Caption

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: MaxLen (64), DisplayName ("Caption")

Краткое описание объекта.

Это свойство наследуется от CIM_ManagedSystemElement.

Compressed

Тип данных: boolean

Тип доступа: только для чтения

Квалификаторы: 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

Тип данных: boolean

Тип доступа: только для чтения

Квалификаторы: Схема ("Win32")

Если задано значение True, устройство использует определяемую пользователем конфигурацию.

Это свойство наследуется от CIM_LogicalDevice.

CreationClassName

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: CIM_Key

Имя первого конкретного класса, отображаемого в цепочке наследования, используемой при создании экземпляра. При использовании с другими ключевыми свойствами класса это свойство позволяет уникально идентифицировать все экземпляры этого класса и его подклассы.

Это свойство наследуется от CIM_LogicalDevice.

Описание

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: DisplayName ("Описание")

Описание объекта.

Это свойство наследуется от CIM_ManagedSystemElement.

DeviceID

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: Key, Override ("DeviceId"), MappingStrings ("WMI")

Уникальный идентификатор массива памяти.

Это свойство наследуется от CIM_LogicalDevice.

Пример: "Массив памяти 1"

ErrorCleared

Тип данных: boolean

Тип доступа: только для чтения

Если задано значение True, ошибка, сообщаемая в LastErrorCode, теперь удаляется.

Это свойство наследуется от CIM_LogicalDevice.

ErrorDescription

Тип данных: string

Тип доступа: только для чтения

Дополнительные сведения об ошибке, записанной в LastErrorCode, и сведения о любых корректирующих действиях, которые можно выполнить.

Это свойство наследуется от CIM_LogicalDevice.

ErrorMethodology

Тип данных: string

Тип доступа: только для чтения

Типы проверки ошибок, используемые оборудованием.

Это свойство наследуется от CIM_StorageExtent.

FileSystem

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("Win32API| Функции файловой системыGetVolumeInformation)

Тип доступа: только для чтения

Файловая система на логическом диске.

Пример: NTFS

FreeSpace

Тип данных: uint64

Тип доступа: только для чтения

Квалификаторы: единицы ("байты")

Свободное место на логическом диске.

Это свойство наследуется от 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

имя;

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: DisplayName ("Имя")

Метка объекта.

Это свойство наследуется от CIM_ManagedSystemElement.

NumberOfBlocks

Тип данных: uint64

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("MIB. IETF| HOST-RESOURCES-MIB.hrStorageSize")

Общее количество последовательных блоков, каждый блок — размер значения, содержащегося в свойстве BlockSize , которые образуют этот экстент хранилища. Общий размер экстента хранилища можно вычислить, умножив значение свойства BlockSize на значение этого свойства. Если значение BlockSize равно 1, это свойство представляет собой общий размер экстента хранилища.

Это свойство наследуется от CIM_StorageExtent.

Дополнительные сведения об использовании значений uint64 в скриптах см. в разделе Создание скриптов в WMI.

PNPDeviceID

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: Schema ("Win32")

Windows Plug and Play идентификатор логического устройства.

Это свойство наследуется от CIM_LogicalDevice.

Пример: "*PNP030b"

PowerManagementCapabilities

Тип данных: массив uint16

Тип доступа: только для чтения

Массив конкретных возможностей логического устройства, связанных с питанием.

Это свойство наследуется от CIM_LogicalDevice.

Неизвестно (0)

Не поддерживается (1)

Отключено (2)

Включено (3)

Функции управления питанием в настоящее время включены, но точный набор функций неизвестен или информация недоступна.

Режимы энергосбережения, введенные автоматически (4)

Устройство может изменять состояние питания в зависимости от использования или других критериев.

Power State Settable (5)

Поддерживается метод SetPowerState . Этот метод находится в родительском CIM_LogicalDevice классе и может быть реализован. Дополнительные сведения см. в разделе Designing Managed Object Format (MOF) Classes.

Поддерживается цикличность питания (6)

Метод SetPowerState можно вызвать с параметром PowerState , равным 5 (цикл питания).

Поддержка включения по времени (7)

Поддержка Power-On по времени

Метод SetPowerState можно вызвать с параметром PowerState , равным 5 (цикл питания), а для параметра Time задана определенная дата и время или интервал для включения питания.

PowerManagementSupported

Тип данных: boolean

Тип доступа: только для чтения

Если задано значение True, устройством можно управлять питанием (можно переводить в режим приостановки и т. д.). Свойство не указывает, что в настоящее время включены функции управления питанием, а только то, что логическое устройство может управлять питанием.

Это свойство наследуется от CIM_LogicalDevice.

ProviderName

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("Win32API| Сетевые функции Windows | WNetGetConnection")

Имя сетевого пути к логическому устройству.

Назначение

Тип данных: string

Тип доступа: только для чтения

Строка свободной формы, описывающая носитель и его использование.

Это свойство наследуется от CIM_StorageExtent.

QuotasDisabled

Тип данных: boolean

Тип доступа: только для чтения

Если значение равно True, управление квотами для этого тома не включено.

QuotasIncomplete

Тип данных: boolean

Тип доступа: только для чтения

Если задано значение True, управление квотами использовалось, но было отключено. Неполный означает сведения, оставшиеся в файловой системе после отключения управления квотами.

QuotasRebuilding

Тип данных: boolean

Тип доступа: только для чтения

Если задано значение True, файловая система настраивает управление квотами.

Sessionid

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: Ключ

Идентификатор сеанса пользователя. Пользователь может быть подключен с помощью локального имени входа или сеанса терминала.

Размер

Тип данных: uint64

Тип доступа: только для чтения

Квалификаторы: единицы ("байты")

Размер логического диска.

Дополнительные сведения об использовании значений uint64 в скриптах см. в разделе Скрипты в WMI.

Это свойство наследуется от CIM_LogicalDisk.

Состояние

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: MaxLen (10), DisplayName ("Status")

Текущее состояние объекта. Можно определить различные операционные и нерабоспособные состояния. Операционные состояния: "ОК", "Понижено" и "Сбой pred" (элемент, например жесткий диск с поддержкой SMART, может работать правильно, но прогнозирует сбой в ближайшем будущем). Неработоспособное состояние: "Ошибка", "Запуск", "Остановка" и "Служба". Состояние службы применяется к административным действиям, таким как зеркало повторное выполнение диска, перезагрузка списка разрешений пользователя или другие административные действия. Не все такие работы доступны в сети, но управляемый элемент не является ни "ОК", ни в одном из других состояний.

Это свойство наследуется от CIM_ManagedSystemElement.

Значения качества производительности:

ОК ("ОК")

Ошибка ("Ошибка")

Пониженный ("Пониженный")

Unknown ("Unknown")

Pred Fail ("Pred Fail")

Запуск ("Начало")

Остановка ("Остановка")

Служба ("Служба")

Подчеркнуто ("Подчеркнуто")

NonRecover ("NonRecover")

Нет контакта ("Нет контакта")

Lost Comm ("Lost Comm")

StatusInfo

Тип данных: uint16

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("MIF. DMTF| Рабочее состояние|003.3")

Состояние логического устройства. Если это свойство не применяется к логическому устройству, следует использовать значение 5 (неприменимо).

Это свойство наследуется от CIM_LogicalDevice.

Другое (1)

Неизвестно (2)

Включено (3)

Отключено (4)

Неприменимо (5)

SupportsDiskQuotas

Тип данных: boolean

Тип доступа: только для чтения

Если задано значение True, файловая система, с которой сопоставлен этот сетевой диск, поддерживает квоты дисков.

SupportsFileBasedCompression

Тип данных: boolean

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("Win32API| | Функции файловой системы | GetVolumeInformation| FS_FILE_COMPRESSION")

Если задано значение True, раздел логического диска поддерживает сжатие на основе файлов, как в случае с NTFS. Это свойство имеет значение False, если свойство Compressed имеет значение True.

SystemCreationClassName

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: распространяется ("CIM_System. CreationClassName"), CIM_Key

Значение свойства CreationClassName компьютера с областью действия.

Это свойство наследуется от CIM_LogicalDevice.

SystemName

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: распространяется ("CIM_System. Name"), CIM_Key

Имя системы определения области.

Это свойство наследуется от CIM_LogicalDevice.

Имя_тома

Тип данных: string

Тип доступа: чтение и запись

Квалификаторы: MappingStrings ("Win32API| | Функции файловой системыGetVolumeInformation)

Имя тома логического диска. Это значение свойства может содержать не более 32 символов.

VolumeSerialNumber

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: MappingStrings ("Win32API| | Функции файловой системыGetVolumeInformation)

Серийный номер тома логического диска. Это значение свойства может содержать не более 11 символов.

Это свойство наследуется от CIM_LogicalDevice.

Пример: "A8C3-D032"

Комментарии

Для этого класса возвращаются следующие экземпляры, предполагающие, что пользователь A перечисляет экземпляры:

  • Поставщик ищет сеанс входа пользователя A на этом компьютере:

    • При наличии одного (и только одного) такого сеанса входа поставщик возвращает сопоставленные диски этого сеанса.
    • Если на компьютере есть несколько сеансов для пользователя A, то сопоставленные экземпляры дисков не возвращаются (так как поставщик не имеет разумного способа решить, какой сеанс использовать).

  • Если сеансы пользователя A не выполняются, а пользователь B локально вошел:

    • При наличии одного сеанса для пользователя B поставщик олицетворяет A и возвращает сопоставленные диски пользователя B. В этом случае поддерживается сценарий службы технической поддержки, который хочет видеть экземпляры локально вошедшего в систему пользователя. Однако то, возвращаются ли экземпляры, зависит от параметров локальной политики безопасности в панель управления Администрирование. Если для следующей политики задано значение "Создатель объекта", сопоставленные экземпляры диска не возвращаются, даже если A является членом группы Администраторы:

      "Системный объект: владелец по умолчанию для объектов, созданных членами группы администраторов".

    • Опять же, если на компьютере выполняется несколько сеансов пользователя 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: диски и файловые системы