Класс Msvm_ComputerSystem

Статья
06/13/2023

Представляет систему физического компьютера или виртуальную машину.

Чтобы получить сведения для VMMS, используйте класс Msvm_VirtualSystemManagementService .

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

Синтаксис

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_ComputerSystem : CIM_ComputerSystem
{
  string   InstanceID;
  string   Caption;
  string   Description;
  string   ElementName;
  datetime InstallDate;
  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 = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   CreationClassName;
  string   Name = "GUID";
  string   PrimaryOwnerName;
  string   PrimaryOwnerContact;
  string   Roles[];
  string   NameFormat;
  string   OtherIdentifyingInfo[];
  string   IdentifyingDescriptions[];
  uint16   Dedicated[];
  string   OtherDedicatedDescriptions[];
  uint16   ResetCapability = 1;
  uint16   PowerManagementCapabilities[];
  uint64   OnTimeInMilliseconds;
  uint32   ProcessID;
  datetime TimeOfLastConfigurationChange;
  uint16   NumberOfNumaNodes;
  uint16   ReplicationState;
  uint16   ReplicationHealth;
  uint16   ReplicationMode;
  uint16   FailedOverReplicationType;
  uint16   LastReplicationType;
  DateTime LastApplicationConsistentReplicationTime;
  DateTime LastReplicationTime;
  DateTime LastSuccessfulBackupTime;
  uint16   EnhancedSessionModeState;
};

Члены

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

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

Методы

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

Метод	Описание
InjectNonMaskableInterrupt	Внедряет немаскируемое прерывание в виртуальную машину. Этот метод поддерживается только для экземпляров класса Msvm_ComputerSystem , представляющих виртуальную машину. Windows 8.1: этот метод не поддерживается до Windows 8.1 и Windows Server 2012 R2.
RequestReplicationStateChange	Запрашивает изменение состояния репликации виртуальной машины на указанное значение. Этот метод поддерживается только для экземпляров класса Msvm_ComputerSystem , представляющих виртуальную машину.
RequestReplicationStateChangeEx	Запрашивает изменение состояния репликации виртуальной машины на указанное значение. Этот метод поддерживается только для экземпляров класса Msvm_ComputerSystem , представляющих виртуальную машину. Windows 8.1: этот метод не поддерживается до Windows 8.1 и Windows Server 2012 R2.
RequestStateChange	Запрашивает изменение состояния виртуальной машины. Этот метод поддерживается только для экземпляров класса Msvm_ComputerSystem , представляющих виртуальную машину.
SetPowerState	Этот метод не поддерживается.

Свойства

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

AvailableRequestedStates

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

Указывает возможные значения параметра RequestedState метода RequestStateChange , используемого для инициации изменения состояния. Перечисленные значения будут подмножеством значений, содержащихся в свойстве RequestedStatesSupported связанного экземпляра CIM_EnabledLogicalElementCapabilities, где выбранные значения являются функцией текущего состояния объекта CIM_EnabledLogicalElement . Это свойство может быть не null , если реализация может объявить набор возможных значений как функцию текущего состояния. Это свойство будет иметь значение Null , если реализация не может определить набор возможных значений как функцию текущего состояния.

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

Включено (2)
Отключено (3)
Завершение работы (4)
Автономный (6)
Тест (7)
Отложить (8)
Заморажи ( 9)
Перезагрузка (10)
Сброс (11)
DmTF Reserved (.. )

Caption

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

Краткое описание объекта. Это свойство наследуется от класса CIM_ManagedElement и будет содержать одно из следующих значений.

Значение	Значение
"Виртуальная машина"	Экземпляр представляет виртуальную машину.
"Размещение компьютерной системы"	Экземпляр представляет хост-компьютер.

CommunicationStatus

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

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

CreationClassName

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

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

Выделенные

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

Указывает, является ли компьютерная система системой специального назначения (предназначенной для конкретного использования), а не системой общего назначения. Это свойство наследуется от CIM_ComputerSystem и всегда имеет значение 0 (не выделенный).

Описание

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

Описание объекта. Это свойство наследуется от CIM_ManagedElement и будет содержать одно из следующих значений.

Значение	Значение
"Microsoft Virtual Computer System"	Экземпляр представляет виртуальную машину.
"Microsoft Hosting Computer System"	Экземпляр представляет хост-компьютер.

DetailedStatus

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

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

ElementName

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

Отображаемое имя объекта. Это свойство наследуется от CIM_ManagedElement и всегда имеет значение отображаемое имя компьютера для виртуальной машины или NetBIOS-имя операционной системы управления.

EnabledDefault

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

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

Включено (2)
Отключено (3)
Включено, но в автономном режиме (6)

EnabledState

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

Включенные и отключенные состояния элемента. Это свойство также может указывать переходы между этими запрошенными состояниями. Это свойство наследуется от класса CIM_EnabledLogicalElement и имеет значение 2 (включено) для физического компьютера или одно из следующих значений для виртуальной машины. Графическое представление этих состояний см. в разделе Примечания.

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

EnhancedSessionModeState

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

Указывает текущее состояние режима расширенного сеанса на виртуальной машине.

Поставщик WMI Hyper-V вызывает __InstanceModificationEvent каждый раз при изменении enhancedSessionModeState класса Msvm_ComputerSystem . Если активный сеанс vmconnection получает __InstanceModificationEvent, он пытается переключиться в режим расширенного сеанса, если пользователь включил этот параметр.

Windows 8.1: это значение не поддерживается до Windows 8.1 и Windows Server 2012 R2.

EnhancedSessionModeState может иметь одно из следующих значений:

Разрешено и доступно (2)

Расширенный режим разрешен и доступен на виртуальной машине.

Запрещено (3)

Расширенный режим не допускается на виртуальной машине.

Разрешено, но недоступно (6)

Расширенный режим разрешен и в настоящее время недоступен на виртуальной машине.

FailedOverReplicationType

Тип данных: uint16
Тип доступа: только для чтения
Квалификаторы: не рекомендуется ("Msvm_ReplicationRelationship. FailedOverReplicationType")

Тип точки данных восстановления, которая была применена во время отработки отказа.

Примечание

Это свойство не рекомендуется использовать, начиная с Windows 8.1. Вместо этого используйте свойство с тем же именем в классе Msvm_ReplicationRelationship, чтобы получить значение для основной или расширенной связи.

Возможны следующие значения:

Нет (0)

Обычный (1)

Согласованность приложений (2)

Запланированный (3)

HealthState

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

Указывает текущую работоспособность элемента. Этот атрибут выражает работоспособность данного элемента, но не обязательно его подкомпонентов.

При возникновении критической ошибки проверка журнал событий для получения дополнительных сведений. Свойство EnabledState также может содержать дополнительные сведения. Например, при критическом нехватке места на диске для HealthState устанавливается значение 25, виртуальная машина приостанавливается, а EnabledState — 32768 (приостановлено).

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

Значение	Значение
OK 5	Виртуальная машина полностью функциональна и работает в нормальных рабочих параметрах и без ошибок.
Крупный сбой 20	На виртуальной машине произошел серьезный сбой. Это значение используется, если на одном или нескольких дисках, содержащих виртуальные жесткие диски виртуальной машины, недостаточно места на диске и виртуальная машина приостановлена.
Критический сбой 25	Элемент является нефункциональным, и восстановление может быть невозможным. Это может означать, что рабочий процесс виртуальной машины (Vmwp.exe) не отвечает на запросы управления или информации или что на одном или нескольких дисках, содержащих виртуальные жесткие диски виртуальной машины, недостаточно места на диске.

IdentifyingDescriptions

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

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

InstallDate

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

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

InstanceID

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

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

В Windows 8 существует один экземпляр ReplicationSettingData для каждой компьютерной системы или виртуальной машины. Для Windows 8.1 виртуальная машина восстановления имеет два экземпляра ReplicationSettingData. Это изменение различает и связывает данные параметров с отношениями репликации.

Имя свойства	значение Windows 8	значение Windows 8.1
InstanceID	Microsoft:<vmguid>\HVR	Microsoft:<vmguid>\HVR\<0/1>

В значении Windows 8.1 0 обозначает первичную репликацию, а 1 — расширенную репликацию. Дополнительные сведения о расширенной репликации см. в разделе Msvm_ReplicationRelationship.

LastApplicationConsistentReplicationTime

Тип данных: DateTime
Тип доступа: только для чтения
Квалификаторы: не рекомендуется ("Msvm_ReplicationRelationship. LastApplicationConsistentReplicationTime")

Время получения последней согласованной с приложениями репликации для виртуальной машины.

Примечание

Это свойство является устаревшим, начиная с Windows 8.1. Вместо этого используйте свойство с тем же именем в классе Msvm_ReplicationRelationship, чтобы получить значение для основной или расширенной связи.

LastReplicationTime

Тип данных: DateTime
Тип доступа: только для чтения
Квалификаторы: не рекомендуется ("Msvm_ReplicationRelationship. LastReplicationTime")

Время получения последней репликации при восстановлении виртуальной машины.

Примечание

LastReplicationType

Тип данных: uint16
Тип доступа: только для чтения
Квалификаторы: не рекомендуется ("Msvm_ReplicationRelationship. LastReplicationType")

Тип последней репликации, полученной для виртуальной машины.

Примечание

Возможны следующие значения:

Нет (0)

Обычный (1)

Согласованность приложений (2)

Запланированные (3)

LastSuccessfulBackupTime

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

Время завершения последнего успешного резервного копирования виртуальной машины.

имя;

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

Метка, по которой известен объект. Это свойство наследуется от CIM_System и всегда имеет значение GUID.

NameFormat

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

Строка, идентифицирующая способ создания имени системы с использованием эвристики подкласса. Это свойство наследуется от CIM_ComputerSystem и всегда имеет значение Null.

NumberOfNumaNodes

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

Количество узлов доступа к неоднородной памяти (NUMA) компьютерной системы. Если Msvm_ComputerSystem представляет компьютерную систему размещения, это свойство содержит количество физических узлов NUMA. Если Msvm_ComputerSystem представляет виртуальную машину, это свойство содержит количество виртуальных узлов NUMA, которые представлены гостевой операционной системе с помощью таблицы сопоставления ресурсов системы ACPI (SRAT).

OnTimeInMilliseconds

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

Для виртуальной машины это свойство указывает время (в миллисекундах) с момента последнего включения, сброса или восстановления компьютера. На этот раз исключается время, когда виртуальная машина находилась в приостановленном состоянии. Для операционной системы управления это свойство имеет значение Null.

OperatingStatus

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

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

OperationalStatus

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

Массив, содержащий текущие состояния объекта . Это свойство наследуется от CIM_ManagedSystemElement. Значение при нулевом индексе (0) является одним из следующих значений.

Значение	Значение
OK 2	Виртуальная машина работает в обычном режиме.
Деградация 3	Виртуальная машина работает только частично. Это означает, что хранилище, содержащее конфигурацию, недоступно. Виртуальную машину в этом состоянии можно только отключить или удалить.
Прогнозируемый сбой 5	Виртуальная машина работает, но в будущем может завершиться сбоем. Это означает, что в хранилище, содержавшемся на виртуальном жестком диске виртуальной машины, недостаточно свободного места. Виртуальная машина будет приостановлена, если не будет доступно больше места на диске.
Остановлена 10	Это значение не поддерживается. Если виртуальная машина остановлена, свойство EnabledState будет иметь значение 3 (отключено).
В службе 11	Виртуальная машина обрабатывает запрос.
Бездействует 15	Это значение не поддерживается. Если виртуальная машина приостановлена или приостановлена, свойство EnabledState будет иметь значение 32769 (приостановлено) или 32768 (приостановлено).

Значение по индексу 1 (1) является необязательным и содержит дополнительные сведения о состоянии. Клиент должен использовать основное состояние из нулевого индекса (0), чтобы определить, может ли новый запрос быть выдан виртуальной машине. Если Значение OperationalStatus[0] равно 2 (ОК), операция, указанная параметром OperationalStatus[1], может быть прервана.

Значение в OperationalStatus[1] является одним из следующих значений.

Значение	Значение
Создание моментального снимка 32768	Для виртуальной машины создается snapshot.
Применение моментального снимка 32769	К виртуальной машине применяется snapshot.
Удаление моментального снимка 32770	Snapshot находится в процессе удаления с виртуальной машины.
Ожидание запуска 32771	Виртуальная машина будет запущена после истечения задержки автоматического запуска.
Слияние дисков 32772	Виртуальные жесткие диски из ранее удаленных моментальных снимков объединяются.
Экспорт виртуальной машины 32773	Выполняется экспорт виртуальной машины.
Перенос виртуальной машины 32774	Виртуальная машина переносится с одного физического компьютера на другой.

OtherDedicatedDescriptions

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

Строка, описывающая, как и почему система выделяется, если выделенный массив содержит значение 2 (Другое). Это свойство наследуется от CIM_ComputerSystem и всегда имеет значение Null.

OtherEnabledState

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

Состояние "Включено" или "Отключено" виртуальной машины, если для свойства EnabledState задано значение 1 (Другое). Это свойство должно иметь значение Null , если EnabledState имеет любое значение, отличное от 1. Это свойство наследуется от CIM_EnabledLogicalElement и всегда имеет значение Null.

OtherIdentifyingInfo

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

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

PowerManagementCapabilities

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

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

PrimaryOwnerContact

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

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

PrimaryOwnerName

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

Имя основного владельца системы. Это свойство наследуется от CIM_System и всегда имеет значение Null.

PrimaryStatus

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

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

ProcessID

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

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

ReplicationHealth

Тип данных: uint16
Тип доступа: только для чтения
Квалификаторы: не рекомендуется ("Msvm_ReplicationRelationship. ReplicationHealth")

Работоспособности репликации для виртуальной машины.

Примечание

Возможны следующие значения:

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

Ок (1)

Предупреждение (2)

Критический (3)

ReplicationMode

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

Указывает режим репликации для виртуальной машины. Это будет одно из следующих значений.

Нет (0)

Основной (1)

Реплика (2)

Восстановление

Тестовая реплика (3)

Реплика

Расширенная реплика (4)

ReplicationState

Тип данных: uint16
Тип доступа: только для чтения
Квалификаторы: не рекомендуется ("Msvm_ReplicationRelationship. ReplicationState")

Состояние репликации для виртуальной машины.

Примечание

Возможны следующие значения:

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

Готово к репликации (1)

Ожидание завершения начальной репликации (2)

Репликация (3)

Синхронизация репликации завершена (4)

Восстановлено (5)

Зафиксировано (6)

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

Критический (8)

Ожидание начала повторной синхронизации (9)

Повторная синхронизация (10)

Повторная синхронизация приостановлена (11)

Выполняется отработка отказа (12)

Выполняется восстановление размещения (13)

Восстановление размещения завершено (14)

RequestedState

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

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

ResetCapability

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

Это свойство наследуется от CIM_ComputerSystem и всегда имеет значение 1 (Другое).

Роли

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

Массив строк, описывающих роли, которые система играет в среде информационных технологий. Это свойство наследуется от CIM_System и всегда имеет значение Null.

Состояние

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

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

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

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

Массив, содержащий строки, описывающие соответствующие значения массива OperationalStatus . Например, если значение 11 (в службе) — это значение, назначенное OperationalStatus[0], то Описание состояния[0] может содержать объяснение того, почему виртуальная машина обрабатывает запрос. Это свойство наследуется от CIM_ManagedSystemElement.

TimeOfLastConfigurationChange

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

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

TimeOfLastStateChange

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

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

TransitioningToState

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

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

При изменении свойства класса Msvm_ComputerSystem поставщик WMI указывает __InstanceModificationEvent событие, описывающее изменения. Предыдущее состояние содержится в свойстве PreviousInstance , а новое — в свойстве TargetInstance . Это событие является асинхронным; к моменту обработки события __InstanceModificationEvent свойство TargetInstance может не отражать текущее состояние.

Доступ к классу Msvm_ComputerSystem может быть ограничен фильтрацией UAC. Дополнительные сведения см. в разделе Контроль учетных записей и инструментарий WMI.

Примеры

См. статью Запросы к сетевым объектам.

Требования

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

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

CIM_ComputerSystem
__InstanceModificationEvent
CIM_ComputerSystem
Msvm_ComputerSystem (версия 1)
Классы виртуальных систем

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

Класс Msvm_ComputerSystem

Синтаксис

Члены

Методы

Свойства

Комментарии

Примеры

Требования

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

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

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