класс Msvm_VirtualEthernetSwitch

Статья
01/28/2024

Представляет виртуальный коммутатор Ethernet. Каждый коммутатор имеет множество разных портов, к которым можно подключить сетевые адаптеры. Сам коммутатор не настраивается с высокой степенью настройки и действует в основном в качестве заполнителя.

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

Синтаксис

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_VirtualEthernetSwitch : CIM_ComputerSystem
{
  string   InstanceID;
  string   Caption = "Virtual Switch";
  string   Description = "Microsoft Virtual Switch";
  string   ElementName;
  datetime InstallDate;
  uint16   OperationalStatus[];
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState = 5;
  string   OtherEnabledState;
  uint16   RequestedState;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   CreationClassName = "Msvm_VirtualEthernetSwitch";
  string   Name = "GUID";
  string   PrimaryOwnerName;
  string   PrimaryOwnerContact;
  string   Roles[];
  string   NameFormat;
  string   OtherIdentifyingInfo[];
  string   IdentifyingDescriptions[];
  uint16   Dedicated[];
  string   OtherDedicatedDescriptions[];
  uint16   ResetCapability = 5;
  uint16   PowerManagementCapabilities[];
  uint32   MaxVMQOffloads;
  uint32   MaxIOVOffloads;
};

Участники

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

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

Методы

Класс Msvm_VirtualEthernetSwitch имеет эти методы.

Метод	Описание
RequestStateChange	Запрашивает изменение состояния.
SetPowerState	Этот метод не поддерживается.

Свойства

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

AvailableRequestedStates

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

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

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

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

Caption

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

Краткое описание объекта. Это свойство наследуется от CIM_ManagedElement и всегда имеет значение "Виртуальный коммутатор".

CommunicationStatus

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

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

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

CreationClassName

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

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

Выделенные

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

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

Описание

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

Описание объекта. Это свойство наследуется от CIM_ManagedElement и всегда имеет значение "Виртуальный коммутатор Майкрософт".

DetailedStatus

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

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

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

ElementName

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

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

EnabledDefault

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

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

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

EnabledState

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

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

HealthState

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

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

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

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

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

IdentifyingDescriptions

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

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

InstallDate

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

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

InstanceID

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

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

MaxIOVOffloads

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

Максимальное количество разгрузк виртуальных функций виртуализации однокорня (SR-IOV), доступных на этом коммутаторе.

MaxVMQOffloads

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

Максимальное количество разгрузки очереди виртуальных машин (VMQ), разрешенных для порта на этом коммутаторе.

Имя

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

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

NameFormat

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

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

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.

OtherDedicatedDescriptions

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

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

OtherEnabledState

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

Включено или отключено состояние элемента, если свойству EnabledState присвоено значение 1 (Other). Это свойство должно иметь значение NULL , если EnabledState имеет любое значение, отличное от 1. Это свойство наследуется от CIM_EnabledLogicalElement и всегда имеет значение NULL.

OtherIdentifyingInfo

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

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

PowerManagementCapabilities

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

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

PrimaryOwnerContact

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

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

PrimaryOwnerName

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

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

PrimaryStatus

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

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

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

RequestedState

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

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

ResetCapability

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

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

Роли

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

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

Состояние

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

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

StatusDescriptions

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

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

TimeOfLastStateChange

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

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

TransitioningToState

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

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

Требования

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