Класс Win32_LogicalDisk

Статья
06/12/2023

Класс WMIWin32_LogicalDisk представляет источник данных, который разрешается в фактическое локальное запоминающее устройство на компьютере под управлением Windows.

Следующий пример синтаксиса — упрощенный MOF-код, который включает все наследуемые свойства. Свойства перечислены в алфавитном порядке, а не в порядке MOF.

Синтаксис

[Dynamic, Provider("CIMWin32"), SupportsUpdate, UUID("{8502C4B7-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_LogicalDisk : CIM_LogicalDisk
{
  uint16   Access;
  uint16   Availability;
  uint64   BlockSize;
  string   Caption;
  boolean  Compressed;
  uint32   ConfigManagerErrorCode;
  boolean  ConfigManagerUserConfig;
  string   CreationClassName;
  string   Description;
  string   DeviceID;
  uint32   DriveType;
  boolean  ErrorCleared;
  string   ErrorDescription;
  string   ErrorMethodology;
  string   FileSystem;
  uint64   FreeSpace;
  datetime InstallDate;
  uint32   LastErrorCode;
  uint32   MaximumComponentLength;
  uint32   MediaType;
  string   Name;
  uint64   NumberOfBlocks;
  string   PNPDeviceID;
  uint16   PowerManagementCapabilities[];
  boolean  PowerManagementSupported;
  string   ProviderName;
  string   Purpose;
  boolean  QuotasDisabled;
  boolean  QuotasIncomplete;
  boolean  QuotasRebuilding;
  uint64   Size;
  string   Status;
  uint16   StatusInfo;
  boolean  SupportsDiskQuotas;
  boolean  SupportsFileBasedCompression;
  string   SystemCreationClassName;
  string   SystemName;
  boolean  VolumeDirty;
  string   VolumeName;
  string   VolumeSerialNumber;
};

Члены

Класс Win32_LogicalDisk имеет следующие типы членов:

Методы
Свойства

Методы

Класс Win32_LogicalDisk содержит следующие методы.

Метод	Описание
Chkdsk	Вызывает операцию Chkdsk на диске.
ExcludeFromAutochk	Исключает диски из операции Chkdsk , выполняемой при следующей перезагрузке.
Сброс	Не реализован. Дополнительные сведения о реализации этого метода см. в разделе Метод Reset в CIM_LogicalDisk документации.
ScheduleAutoChk	Планирует запуск Chkdsk при следующей перезагрузке, если задан бит грязное.
SetPowerState	Не реализован. Дополнительные сведения о реализации этого метода см. в разделе Метод SetPowerState в CIM_LogicalDisk.

Свойства

Класс Win32_LogicalDisk имеет следующие свойства.

Доступ

Тип данных: 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)

Энергосбережение — неизвестно (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, логический том существует в виде одной сжатой сущности, например тома DoubleSpace. Если сжатие на основе файла поддерживается, например в NTFS, это свойство имеет значение False.

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.

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

DriveType

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32API| FileFunctions | GetDriveType")

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

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

Нет корневого каталога (1)

Съемный диск (2)

Локальный диск (3)

Сетевой диск (4)

Компакт-диск (5)

Диск ОЗУ (6)

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. Компонент имени файла — это часть имени файла между обратными косыми чертами. Значение можно использовать, чтобы указать, что длинные имена поддерживаются указанной файловой системой. Например, для файловой системы FAT, поддерживающей длинные имена, функция сохраняет значение 255, а не предыдущий индикатор 8.3. Длинные имена также поддерживаются в системах, использующих файловую систему NTFS.

Пример: 255

MediaType

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32API| Функции ввода и вывода устройства| DeviceIoControl")

Тип носителя, который в настоящее время присутствует на логическом диске. Это значение будет одним из значений перечисления MEDIA_TYPE, определенного в Winioctl.h. Значение может быть не точным для съемных носителей, если в настоящее время на диске нет носителя.

Формат неизвестен (0)

5-дюймовый гибкий диск (1)

5 1/4-дюймовый гибкий диск — 1,2 МБ — 512 байт на сектор

3-дюймовый гибкий диск (2)

3 1/2-дюймовый гибкий диск — 1,44 МБ —512 байт на сектор

3-дюймовый гибкий диск (3)

3 1/2-дюймовый гибкий диск — 2,88 МБ — 512 байт на сектор

3-дюймовый гибкий диск (4)

3 1/2-дюймовый гибкий диск — 20,8 МБ — 512 байт на сектор

3-дюймовый гибкий диск (5)

3 1/2-дюймовый гибкий диск — 720 КБ — 512 байт на сектор

5-дюймовый гибкий диск (6)

5 1/4-дюймовый гибкий диск — 360 КБ — 512 байт на сектор

5-дюймовый гибкий диск (7)

5 1/4-дюймовый гибкий диск — 320 КБ — 512 байт на сектор

5-дюймовый гибкий диск (8)

5 1/4-дюймовый гибкий диск — 320 КБ — 1024 байта на сектор

5-дюймовый гибкий диск (9)

5 1/4-дюймовый гибкий диск — 180 КБ — 512 байт на сектор

5-дюймовый гибкий диск (10)

5 1/4-дюймовый гибкий диск — 160 КБ — 512 байт на сектор

Съемные носители, отличные от гибких дисков (11)

Фиксированный жесткий диск (12)

3-дюймовый гибкий диск (13)

3 1/2-дюймовый гибкий диск — 120 МБ — 512 байт на сектор

3-дюймовый гибкий диск (14)

3 1/2-дюймовый гибкий диск — 640 КБ — 512 байт на сектор

5-дюймовый гибкий диск (15)

5 1/4-дюймовый гибкий диск — 640 КБ — 512 байт на сектор

5-дюймовый гибкий диск (16)

5 1/4-дюймовый гибкий диск — 720 КБ — 512 байт на сектор

3-дюймовый гибкий диск (17)

3 1/2-дюймовый гибкий диск — 1,2 МБ — 512 байт на сектор

3-дюймовый гибкий диск (18)

3 1/2-дюймовый гибкий диск — 1,23 МБ — 1024 байта в сектор

5-дюймовый гибкий диск (19)

5 1/4-дюймовый гибкий диск — 1,23 МБ — 1024 байта в сектор

3-дюймовый гибкий диск (20)

3 1/2-дюймовый гибкий диск — 128 МБ — 512 байт/сектор

3-дюймовый гибкий диск (21)

3 1/2-дюймовый гибкий диск — 230 МБ — 512 байт/сектор

8-дюймовый гибкий диск (22)

8-дюймовый гибкий диск — 256 КБ — 128 байт в сектор

имя;

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: DisplayName ("Name")

Метка, по которой известен объект. При подклассе это свойство может быть переопределено как ключевое свойство.

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

NumberOfBlocks

Тип данных: uint64
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("MIB. IETF| HOST-RESOURCES-MIB.hrStorageSize")

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

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

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

PNPDeviceID

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: Схема ("Win32")

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

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

Пример: "*PNP030b"

PowerManagementCapabilities

Тип данных: массив uint16
Тип доступа: только для чтения

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

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

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

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

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

Включено (3)

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

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

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

Настройка состояния power (5)

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

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

Метод SetPowerState можно вызвать с параметром PowerState , равным 5 (Power Cycle).

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

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

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

PowerManagementSupported

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

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

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

ProviderName

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32API| | Сетевые функции Windows | WNetGetConnection")

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

Назначение

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

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

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

QuotasDisabled

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

Указывает, что в этой системе не включено управление квотами (TRUE).

QuotasIncomplete

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

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

QuotasRebuilding

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

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

Размер

Тип данных: uint64
Тип доступа: только для чтения
Квалификаторы: единицы ("байты")

Размер диска.

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

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

Состояние

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MaxLen (10), DisplayName ("Status")

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

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

В эти значения входят:

ОК ("ОК")

Error ("Error")

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

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.

VolumeDirty

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("FSCTL_IS_VOLUME_DIRTY")

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

Имя тома

Тип данных: string
Тип доступа: чтение и запись
Квалификаторы: MappingStrings ("Win32API| Функции файловой системыGetVolumeInformation)

Имя тома логического диска.

Ограничения: не более 32 символов.

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

VolumeSerialNumber

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("Win32API| Функции файловой системыGetVolumeInformation)

Серийный номер тома логического диска.

Ограничения: не более 11 символов.

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

Физический диск является краеугольным камнем любой системы управления хранилищем. Однако после установки физического диска ни пользователи, ни системные администраторы обычно не имеют дело с оборудованием напрямую. Вместо этого пользователи и системные администраторы взаимодействуют с логическими дисками, созданными на диске.

Логический диск — это подразделение раздела, которому назначена собственная буква диска. (Можно иметь раздел, которому не назначена буква диска.) Когда вы говорите о диске C или D, вы ссылаетесь на логический диск, а не на физический диск. Аналогичным образом, при сохранении документа на диск E вы сохраняете его на логический диск. Физические диски составляют оборудование, из которого состоит диск, включая такие компоненты, как головки, секторы и цилиндры. Логические диски, напротив, имеют такие свойства, как место на диске, доступное дисковое пространство и буквы дисков.

Примечание

Класс Win32_LogicalDisk можно использовать только для перечисления свойств локальных дисков. Однако можно использовать класс Win32_MappedLogicalDisk для перечисления свойств сопоставленных сетевых дисков.

Примеры

Другие примеры использования Win32_LogicalDisk для получения данных диска или тома см. в разделе Задачи WMI: диски и файловые системы .

Пример кода WMI Information Retriever VBScript в коллекции TechNet использует класс Win32_LogicalDisk для получения сведений об оборудовании с нескольких удаленных компьютеров.

Получение сведений о диске с помощью wmi/cim... Пример кода PowerShell в коллекции TechNet использует Win32_LogicalDisk для получения deviceID, VolumeName и Size с целевого устройства. В частности, этот пример включает строгую обработку исключений и возвращает один объект на каждый компьютер, а не на диск.

Корпоративные скрипты часто включают настройку оборудования и программного обеспечения на удаленных компьютерах; в свою очередь, для этого необходимо заранее узнать тип дисков, установленных на компьютере. Например, скрипт, устанавливающий приложение на диск E, работает только в том случае, если диск E является жестким диском. Если диск E представляет собой гибкий диск или компакт-диск, сценарий завершается ошибкой. Следующий код определяет диски и типы дисков, установленные на компьютере.

strComputer = "."
Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colDisks = objWMIService.ExecQuery ("SELECT * FROM Win32_LogicalDisk")
For Each objDisk in colDisks
 Wscript.Echo "DeviceID: "& objDisk.DeviceID 
 Select Case objDisk.DriveType
 Case 1
 Wscript.Echo "No root directory."
 Case 2
 Wscript.Echo "DriveType: Removable drive."
 Case 3
 Wscript.Echo "DriveType: Local hard disk."
 Case 4
 Wscript.Echo "DriveType: Network disk." 
 Case 5
 Wscript.Echo "DriveType: Compact disk." 
 Case 6
 Wscript.Echo "DriveType: RAM disk." 
 Case Else
 Wscript.Echo "Drive type could not be determined."
 End Select
Next


//be sure to References->Add->System.Management to your project
using System.Management;
...
{
   string strComputer = ".";
            
   ManagementScope namespaceScope = new ManagementScope("\\\\" + strComputer + "\\ROOT\\CIMV2");
   ObjectQuery diskQuery = new ObjectQuery("SELECT * FROM Win32_LogicalDisk");
   ManagementObjectSearcher mgmtObjSearcher = new ManagementObjectSearcher(namespaceScope, diskQuery);
   ManagementObjectCollection colDisks = mgmtObjSearcher.Get();

   foreach (ManagementObject objDisk in colDisks)
   {
      Console.WriteLine("Device ID : {0}", objDisk["DeviceID"]);
                
      switch ((uint)(objDisk["DriveType"]))
      {
         case 1: {   Console.WriteLine("No root directory.");
                     break;}
         case 2: {   Console.WriteLine("DriveType: Removable drive."); 
                     break;}
         case 3: {   Console.WriteLine("DriveType: Local hard disk.");
                     break;}
         case 4: {   Console.WriteLine("DriveType: Network disk.");
                     break;}
         case 5: {   Console.WriteLine("DriveType: Compact disk.");
                     break;}
         case 6: {   Console.WriteLine("DriveType: RAM disk.");
                     break;}
         default: {  Console.WriteLine("Drive type could not be determined.");
                     break;}
      }
      //Readline is in here so the user can see the result before the code exists
      Console.ReadLine();
   }
}

В следующих примерах перечисляется свободное место на всех жестких дисках компьютера.

Const HARD_DISK = 3
strComputer = "."
Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colDisks = objWMIService.ExecQuery ("SELECT * FROM Win32_LogicalDisk WHERE DriveType = " & HARD_DISK & "")
For Each objDisk in colDisks
 Wscript.Echo "Device ID: " & objDisk.DeviceID 
 Wscript.Echo "Free Disk Space: " & objDisk.FreeSpace
Next


//be sure to References->Add->System.Management to your project
using System.Management;
...

const int HARD_DISK = 3;
string strComputer = ".";

ManagementScope namespaceScope = new ManagementScope("\\\\" + strComputer + "\\ROOT\\CIMV2");
ObjectQuery diskQuery = new ObjectQuery("SELECT * FROM Win32_LogicalDisk WHERE DriveType = " + HARD_DISK + "");
ManagementObjectSearcher mgmtObjSearcher = new ManagementObjectSearcher(namespaceScope, diskQuery);
ManagementObjectCollection colDisks = mgmtObjSearcher.Get();

foreach (ManagementObject objDisk in colDisks)
{
    Console.WriteLine("Device ID : {0}", objDisk["DeviceID"]);
    Console.WriteLine("Free Disk Space : {0}", objDisk["FreeSpace"]);
    Console.ReadLine();
}

В следующем примере кода возвращается тип файловой системы (FAT, NTFS, FAT32 и т. д.), используемой на каждом диске компьютера.

strComputer = "."
Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\Root\CIMv2")
Set colDisks = objWMIService.ExecQuery ("Select * from Win32_LogicalDisk")
For Each objDisk in colDisks
    Wscript.Echo "DeviceID: "& vbTab &  objDisk.DeviceID  
    Wscript.Echo "File System: "& vbTab & objDisk.FileSystem
Next


Get-WMIObject Win32_LogicalDisk | Select DeviceID, FileSystem | Format=Table -AutoSize

В следующем примере кода PowerShell извлекаются дополнительные сведения о логических локальных дисках.

Write-Host "Drive information for $env:ComputerName"

Get-WmiObject -Class Win32_LogicalDisk |
    Where-Object {$_.DriveType -ne 5} |
    Sort-Object -Property Name | 
    Select-Object Name, VolumeName, FileSystem, Description, VolumeDirty, `
        @{"Label"="DiskSize(GB)";"Expression"={"{0:N}" -f ($_.Size/1GB) -as [float]}}, `
        @{"Label"="FreeSpace(GB)";"Expression"={"{0:N}" -f ($_.FreeSpace/1GB) -as [float]}}, `
        @{"Label"="%Free";"Expression"={"{0:N}" -f ($_.FreeSpace/$_.Size*100) -as [float]}} |
    Format-Table -AutoSize

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Пространство имен	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

См. также раздел

CIM_LogicalDisk
Классы оборудования компьютерной системы
Задачи WMI: диски и файловые системы

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

Класс Win32_LogicalDisk

Синтаксис

Члены

Методы

Свойства

Комментарии

Примеры

Требования

См. также раздел

Обратная связь

Дополнительные ресурсы