Класс Msvm_ExternalEthernetPort

Статья
06/13/2023

Представляет внешний порт Ethernet (сетевой адаптер). Эти типы портов Ethernet предоставляют виртуальным машинам доступ к внешней сети.

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

Синтаксис

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_ExternalEthernetPort : CIM_EthernetPort
{
  string   InstanceID;
  string   Caption = "Ethernet Port";
  string   Description = "Microsoft External Ethernet Port";
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[] = 2;
  string   StatusDescriptions[] = "OK";
  string   Status = "OK";
  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_ExternalEthernetPort";
  string   DeviceID;
  boolean  PowerManagementSupported;
  uint16   PowerManagementCapabilities[];
  uint16   Availability;
  uint16   StatusInfo;
  uint32   LastErrorCode;
  string   ErrorDescription;
  boolean  ErrorCleared;
  string   OtherIdentifyingInfo[];
  uint64   PowerOnHours;
  uint64   TotalPowerOnHours;
  string   IdentifyingDescriptions[];
  string   AdditionalAvailability[];
  uint64   MaxQuiesceTime;
  uint64   Speed;
  uint64   MaxSpeed;
  uint64   RequestedSpeed;
  uint16   UsageRestriction;
  uint16   PortType;
  string   OtherPortType;
  string   OtherNetworkPortType;
  uint16   PortNumber;
  uint16   LinkTechnology;
  string   OtherLinkTechnology;
  string   PermanentAddress;
  string   NetworkAddresses[];
  boolean  FullDuplex;
  boolean  AutoSense;
  uint64   SupportedMaximumTransmissionUnit;
  uint64   ActiveMaximumTransmissionUnit;
  uint32   MaxDataSize;
  uint16   Capabilities[];
  string   CapabilityDescriptions[];
  uint16   EnabledCapabilities[];
  string   OtherEnabledCapabilities[];
  boolean  IsBound;
};

Члены

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

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

Методы

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

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

Свойства

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

ActiveMaximumTransmissionUnit

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

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

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

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

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

Автосенсия

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

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

Доступность

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

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

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
Тип доступа: только для чтения

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

Неизвестно (0)
Другое (1)
AlertOnLan (2)
WakeOnLan (3)
Отработка отказа (4)
LoadBalancing (5)

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

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

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

Caption

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

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

CommunicationStatus

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

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

CreationClassName

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

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

Описание

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

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

DetailedStatus

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

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

DeviceID

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

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

ElementName

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

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

EnabledCapabilities

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

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

Неизвестно (0)
Другое (1)
AlertOnLan (2)
WakeOnLan (3)
Отработка отказа (4)
LoadBalancing (5)

EnabledDefault

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

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

EnabledState

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

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

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

ErrorCleared

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

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

ErrorDescription

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

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

FullDuplex

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

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

HealthState

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

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

IdentifyingDescriptions

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

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

InstallDate

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

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

InstanceID

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

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

IsBound

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

Если это свойство имеет значение True, этот порт Ethernet можно подключить к коммутаторам и таким образом обеспечить подключение к виртуальной машине. Если это свойство имеет значение False, этот порт Ethernet не используется сетевой архитектурой виртуальной машины.

LastErrorCode

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

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

LinkTechnology

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

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

Неизвестно (0)
Другое (1)
Ethernet (2)
IB (3)
FC (4)
FDDI (5)
БАНКОМАТ (6)
Кольцо токена (7)
Ретранслятор кадров (8)
Инфракрасный (9)
BlueTooth (10)
Беспроводная локальная сеть (11)

MaxDataSize

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

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

MaxQuiesceTime

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

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

MaxSpeed

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

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

имя;

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

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

NetworkAddresses

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

Массив строк, содержащих MAC-адреса для порта. Это свойство наследуется от CIM_NetworkPort.

OperatingStatus

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

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

OperationalStatus

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

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

OtherEnabledCapabilities

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

Массив строк свободной формы, предоставляющий более подробное описание любой из включенных возможностей, указанных как 1 (Other.) Это свойство наследуется от CIM_EthernetPort.

OtherEnabledState

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

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

OtherIdentifyingInfo

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

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

OtherLinkTechnology

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

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

OtherNetworkPortType

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

Использование этого свойства является устаревшим вместо свойства PortType . Это свойство наследуется от CIM_NetworkPort.

OtherPortType

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

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

PermanentAddress

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

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

PortNumber

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

номер порта. Это свойство наследуется от CIM_NetworkPort.

Тип порта

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

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

Неизвестно (0)
Другое (1)
//50 Медь 10BaseT (50)
10–100BaseT (51)
100BaseT (52)
1000BaseT (53)
2500BaseT (54)
10GBaseT (55)
10GBase-CX4 (56)
//100 Fibre 100Base-FX (100)
100Base-SX (101)
1000Base-SX (102)
1000Base-LX (103)
1000Base-CX (104)
10GBase-SR (105)
10GBase-SW (106)
10GBase-LX4 (107)
10GBase-LR (108)
10GBase-LW (109)
10GBase-ER (110)
10GBase-EW (111)
Зарезервировано поставщиком (16000 65535)

PowerManagementCapabilities

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

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

PowerManagementSupported

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

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

PowerOnHours

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

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

PrimaryStatus

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

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

RequestedSpeed

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

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

RequestedState

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

Последнее запрошенное или требуемое состояние элемента. Это свойство наследуется от CIM_EnabledLogicalElement и всегда имеет значение 12 (неприменимо).

Скорость

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

Пропускная способность порта в битах в секунду. Это свойство наследуется от CIM_LogicalPort.

Состояние

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

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

"ОК"
ХОРОШО
Ошибка
Деградированных
Неизвестный
Сбой pred
Начиная
Остановки
Службы
Подчеркнул
Невосстановимая
Нет контакта
Lost Comm

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

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

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

StatusInfo

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

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

SupportedMaximumTransmissionUnit

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

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

SystemCreationClassName

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

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

SystemName

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

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

TimeOfLastStateChange

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

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

TotalPowerOnHours

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

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

TransitioningToState

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

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

UsageRestriction

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

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

Неизвестно (0)
Только внешний интерфейс (2)
Только для внутренней части (3)
Не ограничено (4)

Примеры

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

Требования

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

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

CIM_EthernetPort
CIM_EthernetPort

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