Класс Msvm_DiskDrive

Статья
06/12/2023

Представляет жесткий диск в виртуальной машине. Этот жесткий диск может быть либо сквозным устройством (если к виртуальной машине был подключен физический жесткий диск), либо искусственным устройством, заполненным виртуальным жестким диском. Так как виртуальные и физические жесткие диски можно добавлять и удалять из виртуальной машины, с этим классом связаны два пула ресурсов: один для сквозных жестких дисков, а другой — для виртуальных жестких дисков. Жесткие диски можно добавлять или удалять из виртуального контроллера SCSI, только если виртуальная машина подключена к сети. Диски можно добавлять к контроллеру виртуальной интегрированной среды разработки или удалять из него, только если виртуальная машина находится в автономном режиме.

Следующий синтаксис представляет собой упрощенный код MOF и включает все унаследованные свойства.

Синтаксис

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_DiskDrive : CIM_DiskDrive
{
  string   InstanceID;
  string   Caption;
  string   Description;
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[];
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState = 2;
  string   OtherEnabledState;
  uint16   RequestedState;
  uint16   EnabledDefault;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName;
  string   SystemName;
  uint16   CreationClassName;
  string   DeviceID;
  boolean  PowerManagementSupported;
  uint16   PowerManagementCapabilities[];
  uint16   Availability;
  uint16   StatusInfo;
  uint32   LastErrorCode;
  string   ErrorDescription;
  boolean  ErrorCleared;
  string   OtherIdentifyingInfo[];
  uint64   PowerOnHours;
  uint64   TotalPowerOnHours;
  string   IdentifyingDescriptions[];
  uint16   AdditionalAvailability[] = { 6 };
  uint64   MaxQuiesceTime;
  uint16   Capabilities[];
  string   CapabilityDescriptions[];
  string   ErrorMethodology = "None";
  string   CompressionMethod = "Not Compressed";
  uint32   NumberOfMediaSupported = 1;
  uint64   MaxMediaSize = 2000000000;
  uint64   DefaultBlockSize = 512;
  uint64   MaxBlockSize;
  uint64   MinBlockSize = 512;
  boolean  NeedsCleaning = False;
  boolean  MediaIsLocked = True;
  uint16   Security = 3;
  datetime LastCleaned;
  uint64   MaxAccessTime = 0;
  uint32   UncompressedDataRate;
  uint64   LoadTime = 0;
  uint64   UnloadTime = 0;
  uint64   MountCount = 0;
  datetime TimeOfLastMount;
  uint64   TotalMountTime = 0;
  string   UnitsDescription;
  uint64   MaxUnitsBeforeCleaning = 0xffffffffffffffff;
  uint64   UnitsUsed = 0;
  uint32   DriveNumber;
};

Члены

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

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

Методы

Класс Msvm_DiskDrive содержит эти методы.

Метод	Описание
EnableDevice	Этот метод не поддерживается.
LockMedia	Блокирует или освобождает носитель.
OnlineDevice	Этот метод не поддерживается.
QuiesceDevice	Этот метод не поддерживается.
RequestStateChange	Запрашивает изменение состояния.
Reset	Сбрасывает виртуальное устройство.
Свойства RestoreProperties	Этот метод не поддерживается.
Saveproperties	Этот метод не поддерживается.
SetPowerState	Этот метод не поддерживается.

Свойства

Класс Msvm_DiskDrive имеет эти свойства.

Дополнительная Доступность

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

Это свойство наследуется от CIM_LogicalDevice и имеет значение 6 (неприменимо).

Доступность

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

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

AvailableRequestedStates

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

Указывает возможные значения для параметра RequestedState метода RequestStateChange . Это свойство наследуется от CIM_EnabledLogicalElement.

Capabilities

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

Возможности устройства доступа к мультимедиа. Это свойство наследуется от CIM_MediaAccessDevice и имеет следующие значения.

Значение	Значение
3	Соответствующая запись в CapabilityDescriptions — "Случайный доступ".
4	Соответствующая запись в CapabilityDescriptions — "Поддерживает запись".

Описания возможностей

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

Массив строк свободной формы, предоставляющий подробные объяснения возможностей доступа к устройствам, указанным в массиве свойств Capabilities . Каждая запись этого массива связана с записью в массиве свойств Capabilities , расположенном по тому же индексу. Это свойство наследуется от CIM_MediaAccessDevice.

Caption

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

Краткое описание объекта . Это свойство наследуется от CIM_ManagedElement.

CommunicationStatus

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

Указывает возможность инструментирования взаимодействовать с базовым управляемым элементом. Значение NULL указывает, что это свойство не реализовано. Это свойство наследуется от CIM_ManagedSystemElement.

Неизвестно (0)
Недоступно (1)
Связь ОК (2)
Потерянная связь (3)
Нет контакта (4)
Зарезервировано DMTF (..)
Зарезервировано поставщиком (0x8000.. )

CompressionMethod

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

Строка, указывающая алгоритм или средство, используемые для сжатия логического файла. Если схема сжатия неизвестна или не описана, используйте "Unknown". Если логический файл сжат, но схема сжатия неизвестна или не описана, используйте "Сжатый". Если логический файл не сжат, используйте команду "Не сжимается". Это свойство наследуется от CIM_MediaAccessDevice и имеет значение Not Compressed.

CreationClassName

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

Имя класса или подкласса, используемого при создании экземпляра. Это свойство наследуется от CIM_LogicalDevice.

DefaultBlockSize

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

Размер блока по умолчанию (в байтах) для устройства. Это свойство наследуется от CIM_MediaAccessDevice и имеет значение 512.

Описание

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

Описание объекта. Это свойство наследуется от CIM_ManagedElement.

DetailedStatus

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

Дополняет свойство PrimaryStatus дополнительными сведениями о состоянии. Значение NULL указывает, что это свойство не реализовано. Это свойство наследуется от CIM_ManagedSystemElement.

Недоступно (0)
Нет дополнительной информации (1)
Подчеркнуто (2)
Прогнозный сбой (3)
Ошибка, неизменяемая (4)
Ошибка поддержки сущности (5)
DmTF Reserved (..)
Зарезервировано поставщиком (0x8000.. )

DeviceID

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

Адрес или другие идентифицирующие сведения для уникального имени логического устройства. Это свойство наследуется от CIM_LogicalDevice.

DriveNumber

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

Количество физических дисков в системе размещения компьютера.

ElementName

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

Отображаемое имя объекта. Это свойство наследуется от CIM_ManagedElement.

EnabledDefault

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

Конфигурация администратора по умолчанию или конфигурация запуска для включенного состояния элемента. Это свойство наследуется от CIM_EnabledLogicalElement.

EnabledState

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

Включенные и отключенные состояния элемента. Он также может указывать переходы между этими запрошенными состояниями. Это свойство наследуется от CIM_EnabledLogicalElement.

Значение	Значение
Unknown 0	Не удалось определить состояние элемента.
Другое 1
Enabled 2	Элемент выполняется.
Отключено 3	Элемент отключен.
Завершает работу 4	Элемент находится в процессе переключения в состояние Отключено.
Неприменимо 5	Элемент не поддерживает включение или отключение.
Включено, но в автономном режиме 6	Элемент может выполнять команды и удалять все новые запросы.
В тесте 7	Элемент находится в тестовом состоянии.
Отложенные 8	Элемент может выполнять команды, но он будет ставить в очередь все новые запросы.
Замораживание 9	Элемент включен, но он находится в ограниченном режиме. Поведение элемента аналогично состоянию Enabled (2), но он обрабатывает только ограниченный набор команд. Все остальные запросы помещаются в очередь.
Запуск 10	Элемент находится в процессе переключения в состояние Enabled (2). Новые запросы помещаются в очередь.

ErrorCleared

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

Это свойство наследуется от CIM_LogicalDevice, но не используется.

ErrorDescription

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

Это свойство наследуется от CIM_LogicalDevice, но не используется.

ErrorMethodology

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

Строка, описывающая типы обнаружения и исправления ошибок, поддерживаемые этим устройством. Это свойство наследуется от CIM_MediaAccessDevice и имеет значение None.

HealthState

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

Текущая работоспособность элемента. Этот атрибут выражает работоспособность данного элемента, но не обязательно его подкомпонентов. Возможные значения: от 0 до 30, где 5 означает, что элемент полностью работоспособен, а 30 означает, что элемент полностью нефункциональный. Это свойство наследуется от CIM_ManagedSystemElement и всегда имеет значение 5.

IdentifyingDescriptions

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

Это свойство наследуется от CIM_LogicalDevice и имеет значение Null.

InstallDate

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

Дата и время создания конфигурации виртуальной машины. Это свойство наследуется от CIM_ManagedSystemElement.

InstanceID

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

Уникально идентифицирует экземпляр этого класса. Это свойство наследуется от CIM_ManagedElement.

LastCleaned

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

Дата и время последней очистки устройства. Это свойство наследуется от CIM_MediaAccessDevice и имеет значение Null.

LastErrorCode

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

Это свойство наследуется от CIM_LogicalDevice, но не используется.

LoadTime

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

Время (в миллисекундах) от загрузки до возможности чтения или записи носителя. Например, для дисков это интервал между диском, не вращающимся и сообщающим о том, что он готов к чтению и записи (т. е. диск вращается с номинальной скоростью). Для ленточных накопителей это время от внедрения носителя до сообщения о том, что он готов для приложения. Обычно это происходит в области бота ленты. Это свойство наследуется от CIM_MediaAccessDevice и имеет значение 0.

MaxAccessTime

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

Время (в миллисекундах) перехода из первого расположения на носителе в расположение, которое является самым дальним по отношению к времени. Для диска это означает полный поиск и полную задержку вращения. Для ленточных накопителей это представляет собой поиск от начала ленты до наиболее физически удаленной точки. (Конец ленты может находиться в самой отдаленной физической точке, но это не обязательно так.) Это свойство наследуется от CIM_MediaAccessDevice и имеет значение 0.

MaxBlockSize

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

Максимальный размер блока (в байтах) для мультимедиа, к которым обращается устройство. Это свойство наследуется от CIM_MediaAccessDevice и имеет значение 512 для виртуальных жестких дисков и переменной для сквозных дисков.

MaxMediaSize

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

Максимальный размер (в килобайтах) носителя, поддерживаемого этим устройством. Килобайты интерпретируются как число байтов, умноженных на 1000 (а не число байтов, умноженное на 1024). Это свойство наследуется от CIM_MediaAccessDevice и имеет значение 2 000 000 000 000 для виртуальных жестких дисков и переменной для сквозных дисков.

MaxQuiesceTime

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

Это свойство наследуется от CIM_LogicalDevice, но не используется.

MaxUnitsBeforeCleaning

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

Максимальное количество единиц, которое можно использовать перед очисткой устройства. Это свойство наследуется от CIM_MediaAccessDevice и имеет значение 0xffffffffffffffff.

MediaIsLocked

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

Значение true , если носитель заблокирован на устройстве и не может быть извлечен; в противном случае — False. Это свойство наследуется от CIM_MediaAccessDevice и имеет значение True.

MinBlockSize

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

Минимальный размер блока (в байтах) для мультимедиа, к которым обращается устройство. Это свойство наследуется от CIM_MediaAccessDevice и имеет значение 512.

MountCount

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

Для устройства, поддерживающего съемный носитель, — количество раз, когда носитель был подключен для передачи данных или очистки устройства. Для устройств, обращаюющихся к неустранимым носителям, таким как жесткие диски, это свойство неприменимо и должно иметь значение 0. Это свойство наследуется от CIM_MediaAccessDevice и имеет значение 0.

имя;

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

Метка, по которой известен объект. Это свойство наследуется от CIM_ManagedSystemElement.

NeedsCleaning

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

Значение true , если устройство доступа к мультимедиа нуждается в очистке; в противном случае — False. Это свойство наследуется от CIM_MediaAccessDevice и имеет значение False.

NumberOfMediaSupported

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

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

OperatingStatus

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

Предоставляет текущие сведения о состоянии рабочего состояния элемента и может использоваться для предоставления дополнительных сведений о значении свойства EnabledState . Значение NULL указывает, что это свойство не реализовано. Это свойство наследуется от CIM_ManagedSystemElement.

Неизвестно (0)
Недоступно (1)
Обслуживание (2)
Начиная с (3)
Остановка (4)
Остановлено (5)
Прервано (6)
Бездействующий (7)
Завершено (8)
Миграция (9)
Эмигрировавшие (10)
Иммиграция (11)
Создание моментальных снимков (12)
Завершение работы (13)
В тесте (14)
Переход ( 15)
В службе (16)
DmTF Reserved (..)
Зарезервировано поставщиком (0x8000.. )

OperationalStatus

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

Текущие состояния объекта. Это свойство наследуется от CIM_ManagedSystemElement.

OtherEnabledState

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

Состояние enabled или disabled элемента, если свойство EnabledState имеет значение 1 (Other). Это свойство должно иметь значение Null , если EnabledState имеет любое значение, отличное от 1. Это свойство наследуется от CIM_EnabledLogicalElement и всегда имеет значение Null.

OtherIdentifyingInfo

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

Это свойство наследуется от CIM_LogicalDevice и имеет значение Null.

PowerManagementCapabilities

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

Это свойство наследуется от CIM_LogicalDevice, но не используется.

PowerManagementSupported

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

Это свойство наследуется от CIM_LogicalDevice, но не используется.

PowerOnHours

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

Это свойство наследуется от CIM_LogicalDevice, но не используется.

PrimaryStatus

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

Предоставляет сведения о состоянии высокого уровня. Это свойство следует использовать в сочетании со свойством DetailedStatus , чтобы обеспечить высокий уровень и подробное состояние работоспособности элемента и его подкомпонентов. Значение NULL указывает, что это свойство не реализовано. Это свойство наследуется от CIM_ManagedSystemElement.

Неизвестно (0)
ОК (1)
Пониженная производительность (2)
Ошибка (3)
DmTF Reserved (..)
Зарезервировано поставщиком (0x8000.. )

RequestedState

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

Последнее запрошенное или требуемое состояние элемента. Фактическое состояние элемента представлено EnabledState. Это свойство предоставляется для сравнения последнего запрошенного и текущего состояний включения или отключения. Конкретный экземпляр CIM_EnabledLogicalElement может не поддерживать метод RequestStateChange . В этом случае используется значение 12 (неприменимо). Это свойство наследуется от CIM_EnabledLogicalElement.

Безопасность

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

Операционная безопасность, определенная для устройства. Это свойство наследуется от CIM_MediaAccessDevice и имеет значение 3 (Нет).

Состояние

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

Это свойство наследуется от CIM_ManagedSystemElement, но не используется.

Описания состояния

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

Строки, описывающие различные значения массива OperationalStatus . Это свойство наследуется от CIM_ManagedSystemElement.

StatusInfo

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

Это свойство наследуется от CIM_LogicalDevice, но не используется.

SystemCreationClassName

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

Имя класса создания системы области. Это свойство наследуется от CIM_LogicalDevice.

SystemName

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

Уникальный идентификатор виртуальной машины с областью действия. Это свойство наследуется от CIM_LogicalDevice.

TimeOfLastMount

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

Для устройства, поддерживающего съемный носитель, — самые последние дата и время подключения носителя на устройстве. Для устройств, обращаюющихся к неотменяемому носителю, например к жестким дискам, это свойство не имеет значения и неприменимо. Это свойство наследуется от CIM_MediaAccessDevice и имеет значение Null.

TimeOfLastStateChange

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

Дата или время последнего изменения состояния включенного элемента. Это свойство наследуется от CIM_EnabledLogicalElement и всегда имеет значение NULL.

TotalMountTime

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

Для устройства, поддерживающего съемный носитель, общее время (в секундах) подключения носителя для передачи данных или очистки устройства. Для устройств, обращаюющихся к неотменяемому носителю, например к жестким дискам, это свойство неприменимо и должно иметь значение 0. Это свойство наследуется от CIM_MediaAccessDevice и имеет значение 0.

TotalPowerOnHours

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

Это свойство наследуется от CIM_LogicalDevice, но не используется.

TransitioningToState

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

Указывает целевое состояние, в которое переходит экземпляр. Это свойство наследуется от CIM_EnabledLogicalElement.

UncompressedDataRate

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

Устойчивая скорость передачи данных в КБ/с, которую устройство может считывать и записывать на носитель. Это устойчивая, необработанная скорость передачи данных. В этом свойстве не следует сообщать о максимальной скорости или скорости сжатия. Это свойство наследуется от CIM_MediaAccessDevice и имеет значение Null.

Описание единиц

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

Единицы измерения относительно его использования в MaxUnitsBeforeCleaning. Это свойство наследуется от CIM_MediaAccessDevice и имеет значение Null.

UnitsUsed

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

Текущее количество используемых единиц. Это свойство наследуется от CIM_MediaAccessDevice и имеет значение 0.

UnloadTime

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

Время (в миллисекундах) от возможности чтения или записи носителя до его выгрузки. Это свойство наследуется от CIM_MediaAccessDevice и имеет значение 0.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8 [только классические приложения]
Минимальная версия сервера	Windows Server 2012 [только классические приложения]
Пространство имен	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

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

CIM_DiskDrive
CIM_DiskDrive
Классы хранения

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

Класс Msvm_DiskDrive

Синтаксис

Члены

Методы

Свойства

Комментарии

Требования

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

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

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