Класс Msvm_EmulatedEthernetPort

Статья
06/12/2023

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

Примечание

Этот класс недоступен для виртуальных машин 2-го поколения.

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

Синтаксис

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_EmulatedEthernetPort : CIM_EthernetPort
{
  string   InstanceID;
  string   Caption = "Ethernet Port";
  string   Description = "Microsoft Emulated Ethernet Port";
  string   ElementName = "Legacy Network Adapter";
  datetime InstallDate;
  string   Name = "Ethernet Port";
  uint16   OperationalStatus[] = 2;
  string   StatusDescriptions[] = "OK";
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState = 5;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName = "Msvm_ComputerSystem";
  string   SystemName;
  string   CreationClassName = "Msvm_EmulatedEthernetPort";
  string   DeviceID = "Microsoft:GUID\device-specific data";
  boolean  PowerManagementSupported;
  uint16   PowerManagementCapabilities[];
  uint16   Availability;
  uint16   StatusInfo;
  uint32   LastErrorCode;
  string   ErrorDescription;
  boolean  ErrorCleared;
  string   OtherIdentifyingInfo[];
  uint64   PowerOnHours;
  uint16   TotalPowerOnHours;
  string   IdentifyingDescriptions[];
  uint16   AdditionalAvailability[] = 6;
  uint64   MaxQuiesceTime;
  uint64   Speed = 1000000000;
  uint64   MaxSpeed = 1000000000;
  uint64   RequestedSpeed = 1000000000;
  uint16   UsageRestriction = 4;
  uint16   PortType = 1;
  string   OtherPortType = "Virtual Ethernet";
  string   OtherNetworkPortType;
  uint16   PortNumber;
  uint16   LinkTechnology = 2;
  string   OtherLinkTechnology;
  string   PermanentAddress;
  string   NetworkAddresses[];
  boolean  FullDuplex = True;
  boolean  AutoSense = True;
  string   SupportedMaximumTransmissionUnit = 1500;
  uint64   ActiveMaximumTransmissionUnit = 1500;
  uint32   MaxDataSize = 1500;
  uint16   Capabilities[];
  string   CapabilityDescriptions[];
  uint16   EnabledCapabilities[];
  string   OtherEnabledCapabilities[];
};

Члены

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

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

Методы

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

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

Свойства

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

ActiveMaximumTransmissionUnit

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

Активная или согласованная максимальная единица передачи (MTU), которую можно поддерживать. Это свойство наследуется от CIM_NetworkPort и всегда имеет значение 1500.

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

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

Любые дополнительные сведения о доступности и состоянии устройства, помимо указанного в свойстве Availability . Это свойство наследуется от CIM_LogicalDevice и всегда имеет значение 6 ("Неприменимо").

Автосенсия

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

Указывает, может ли сетевой порт автоматически определять скорость или другие характеристики связи подключенного сетевого носителя. Это свойство наследуется от CIM_NetworkPort и всегда имеет значение True.

Доступность

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

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

AvailableRequestedStates

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

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

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

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

Capabilities

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

Возможности порта Ethernet. Это свойство наследуется от CIM_EthernetPort и не используется.

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

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

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

Caption

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

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

CommunicationStatus

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

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

CreationClassName

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

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

Описание

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

Описание объекта. Это свойство наследуется от CIM_ManagedElement и всегда имеет значение "Microsoft Emulated Ethernet Port".

DetailedStatus

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

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

DeviceID

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

Адрес или другие идентифицирующие сведения, используемые для уникального имени логического устройства. Это свойство наследуется от CIM_LogicalDevice и всегда имеет значение Microsoft:GUID\для устройств.

ElementName

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

Отображаемое имя объекта. Это свойство наследуется от CIM_ManagedElement и всегда имеет значение "Устаревший сетевой адаптер".

EnabledCapabilities

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

Возможности, которые включены из списка всех поддерживаемых, которые определены в массиве Capabilities . Это свойство наследуется от CIM_EthernetPort, но не используется.

EnabledDefault

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

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

EnabledState

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

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

ErrorCleared

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

Указывает, снята ли ошибка, сообщаемая в LastErrorCode . Это свойство наследуется от CIM_LogicalDevice и не используется.

ErrorDescription

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

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

FullDuplex

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

Указывает, работает ли порт в полнодуплексном режиме. Это свойство наследуется от CIM_NetworkPort и всегда имеет значение True.

HealthState

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

Текущая работоспособность элемента. Этот атрибут выражает работоспособность этого элемента, но не обязательно его подкомпонентов. Это свойство наследуется от CIM_ManagedSystemElement и всегда имеет значение 5 ("ОК").

IdentifyingDescriptions

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

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

InstallDate

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

Значение даты и времени , указывающее, когда был установлен объект. Отсутствие значения не означает, что объект не установлен. Это свойство наследуется от CIM_ManagedSystemElement.

InstanceID

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

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

LastErrorCode

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

Последний код ошибки, сообщаемый логическим устройством. Это свойство наследуется от CIM_LogicalDevice и не используется.

LinkTechnology

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

Типы ссылок. Если задано значение 1 ("Другое"), связанное свойство OtherLinkTechnology содержит строковое описание типа ссылки. Это свойство наследуется от CIM_NetworkPort и всегда имеет значение 2 ("Ethernet").

MaxDataSize

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

Максимальный размер поля INFO (не mac), которое будет получено или передано. Это свойство наследуется от CIM_EthernetPort и всегда имеет значение 1500.

MaxQuiesceTime

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

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

MaxSpeed

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

Максимальная пропускная способность порта в битах в секунду. Это свойство наследуется от CIM_LogicalPort и всегда имеет значение 1000000000.

имя;

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

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

NetworkAddresses

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

MAC-адреса Ethernet/802.3, отформатированные в виде двенадцати шестнадцатеричных цифр (например, "010203040506"), при этом каждая пара представляет один из шести октетов MAC-адреса в каноническом битовом порядке (бит адреса группы находится в бите нижнего порядка первого символа строки). Это свойство наследуется от CIM_EthernetPort и не используется.

OperatingStatus

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

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

OperationalStatus

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

Текущее состояние элемента. Это свойство наследуется от CIM_ManagedSystemElement и всегда имеет значение 2 ("ОК").

OtherEnabledCapabilities

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

Массив строк свободной формы, предоставляющий более подробное описание любой из включенных возможностей, указанных как "Другое". Это свойство наследуется от CIM_EthernetPort и не используется.

OtherEnabledState

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

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

OtherIdentifyingInfo

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

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

OtherLinkTechnology

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

Строковое значение, описывающее LinkTechnology , если для него задано значение 1 ("Другое"). Это свойство наследуется от CIM_NetworkPort, но не используется.

OtherNetworkPortType

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

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

OtherPortType

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

Тип модуля, если параметр PortType имеет значение 1 ("Другое"). Это свойство наследуется от CIM_LogicalPort и всегда имеет значение Virtual Ethernet.

PermanentAddress

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

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

PortNumber

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

Сетевые порты часто нумеруются относительно логического модуля или сетевого элемента. Это свойство наследуется от CIM_NetworkPort.

Значение	Значение
0	Сетевой адаптер не эмулируется.
1	Сетевой адаптер эмулируется.

Тип порта

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

Конкретный режим, который в настоящее время включен для порта. Если задано значение 1 ("Другое"), связанное свойство OtherPortType содержит строковое описание типа порта. Это свойство наследуется от CIM_EthernetPort и всегда имеет значение 1 ("Другое").

PowerManagementCapabilities

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

Возможности управления питанием устройства. Это свойство наследуется от CIM_LogicalDevice и не используется.

PowerManagementSupported

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

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

PowerOnHours

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

Количество последовательных часов питания этого устройства с момента последнего цикла питания. Это свойство наследуется от CIM_LogicalDevice и не используется.

PrimaryStatus

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

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

RequestedSpeed

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

Запрошенная пропускная способность порта в битах в секунду. Фактическая пропускная способность отображается в LogicalPort.Speed. Это свойство наследуется от CIM_LogicalPort и всегда имеет значение 1000000000.

RequestedState

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

Последнее запрошенное или требуемое состояние для службы управления. Если enabledState имеет значение 5 ("Неприменимо"), это свойство не имеет значения. Это свойство наследуется от CIM_EnabledLogicalElement и всегда имеет значение 12 ("Неприменимо").

Скорость

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

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

Состояние

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

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

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

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

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

StatusInfo

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

Состояние логического устройства. Это свойство наследуется от CIM_LogicalDevice и не используется.

SupportedMaximumTransmissionUnit

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

Максимальная поддерживаемая единица передачи (MTU) в байтах. Это свойство наследуется от CIM_NetworkPort и всегда имеет значение 1500.

SystemCreationClassName

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

Имя класса создания системы определения области. Это свойство наследуется от CIM_LogicalDevice и всегда имеет значение "Msvm_ComputerSystem".

SystemName

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

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

TimeOfLastStateChange

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

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

TotalPowerOnHours

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

Общее количество часов питания этого устройства. Это свойство наследуется от CIM_LogicalDevice и не используется.

TransitioningToState

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

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

UsageRestriction

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

В некоторых случаях логический порт может быть идентифицирован как внешний или внутренний порт. Если нет ограничений на использование порта, следует задать значение 4 ("Не ограничено"). Это свойство наследуется от CIM_LogicalPort и всегда имеет значение 4 ("Не ограничено").

Примеры

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

Требования

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

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

CIM_EthernetPort
CIM_EthernetPort

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