Класс Msvm_InternalEthernetPort

Статья
06/13/2023

Представляет внутренний порт Ethernet (сетевой адаптер). Этот тип порта Ethernet предоставляет виртуальным машинам доступ к серверу виртуализации, на котором выполняется сетевое программное обеспечение. Внутренние сетевые адаптеры позволяют маршрутизировать или фильтровать сетевой трафик виртуальных машин перед выходом из физической системы.

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

Синтаксис

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_InternalEthernetPort : CIM_EthernetPort
{
  string   InstanceID;
  string   Caption = "Ethernet Port";
  string   Description = "Microsoft Internal Ethernet Port";
  string   ElementName;
  datetime InstallDate;
  string   Name;
  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_InternalEthernetPort";
  string   DeviceID;
  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   MaxSpeed = 1000000000;
  uint64   RequestedSpeed = 1000000000;
  uint16   UsageRestriction = 4;
  string   OtherPortType;
  uint64   Speed;
  string   OtherNetworkPortType;
  uint16   PortNumber;
  uint16   LinkTechnology = 2;
  string   OtherLinkTechnology;
  string   PermanentAddress;
  boolean  FullDuplex = True;
  boolean  AutoSense = True;
  uint64   SupportedMaximumTransmissionUnit = 1500;
  uint64   ActiveMaximumTransmissionUnit = 1500;
  uint16   PortType;
  string   NetworkAddresses[];
  uint32   MaxDataSize = 1500;
  uint16   Capabilities[];
  string   CapabilityDescriptions[];
  uint16   EnabledCapabilities[];
  string   OtherEnabledCapabilities[];
};

Члены

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

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

Методы

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

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

Свойства

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

ActiveMaximumTransmissionUnit

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

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

AdditionalAvailability

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

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

Автозакзания

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

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

Доступность

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

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

AvailableRequestedStates

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

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

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

Capabilities

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

Возможности порта Ethernet. Если перечислены возможности отработки отказа или балансировки нагрузки, необходимо также определить CIM_SpareGroup (отработка отказа) или CIM_ExtraCapacityGroup (балансировка нагрузки), чтобы полностью описать эти возможности. Это свойство наследуется от CIM_EthernetPort.

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

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

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

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

Caption

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

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

CommunicationStatus

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

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

CreationClassName

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

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

Описание

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

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

DetailedStatus

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

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

DeviceID

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

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

ElementName

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

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

EnabledCapabilities

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

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

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

EnabledDefault

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

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

EnabledState

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

Включенные и отключенные состояния элемента. Это свойство наследуется от CIM_EnabledLogicalElement.

ErrorCleared

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

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

ErrorDescription

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

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

FullDuplex

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

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

HealthState

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

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

IdentifyingDescriptions

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

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

InstallDate

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

Значение типа 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.

MaxQuiesceTime

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

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

MaxSpeed

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

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

имя;

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

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

NetworkAddresses

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

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

OperatingStatus

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

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

OperationalStatus

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

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

OtherEnabledCapabilities

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

Массив строк свободной формы, предоставляющий более подробные объяснения для любой из включенных возможностей, указанных как 1 (Другое). Это свойство наследуется от 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.

Нерекомендуемое описание: тип модуля, если для свойства PortType задано значение 1 (Другое).

OtherPortType

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

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

PermanentAddress

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

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

Номер порта

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

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

Тип порта

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

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

Неизвестно (0)
Другое (1)
//50 Copper 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
Тип доступа: только для чтения

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

Скорость

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

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

Состояние

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

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

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

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

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

StatusInfo

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

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

SupportedMaximumTransmissionUnit

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

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

SystemCreationClassName

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

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

SystemName

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

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

TimeOfLastStateChange

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

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

TotalPowerOnHours

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

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

TransitioningToState

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

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

UsageRestriction

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

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

Значение	Значение
4	Не ограничено

Примеры

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

Требования

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

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

CIM_EthernetPort
CIM_EthernetPort

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