Класс Msvm_SyntheticEthernetPort

Статья
06/12/2023

Представляет синтетический адаптер Ethernet. Этот адаптер является предпочтительным сетевым адаптером из-за его производительности и потому, что изменения в него могут вступают в силу сразу же, пока он используется (горячая возможность настройки).

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

Синтаксис

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_SyntheticEthernetPort : CIM_EthernetPort
{
  string   InstanceID;
  string   Caption;
  string   Description;
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[] = 2;
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState;
  string   OtherEnabledState;
  uint16   RequestedState;
  uint16   EnabledDefault;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName;
  string   SystemName;
  string   CreationClassName;
  string   DeviceID;
  boolean  PowerManagementSupported;
  uint16   PowerManagementCapabilities[];
  uint16   Availability;
  uint16   StatusInfo;
  uint32   LastErrorCode;
  string   ErrorDescription;
  boolean  ErrorCleared;
  string   OtherIdentifyingInfo[];
  uint64   PowerOnHours;
  uint64   TotalPowerOnHours;
  string   IdentifyingDescriptions[];
  uint16   AdditionalAvailability[] = 6;
  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[];
};

Члены

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

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

Методы

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

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

Свойства

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

ActiveMaximumTransmissionUnit

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

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

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

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

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

Автосенсия

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

Возможности порта Ethernet. Например, устройство может поддерживать AlertOnLan, WakeOnLan, Load Balanceing или FailOver. Если в списке перечислены возможности отработки отказа или балансировки нагрузки, для полного описания этой возможности также следует определить SpareGroup (отработка отказа) или ExtraCapacityGroup (балансировка нагрузки). Это свойство наследуется от CIM_EthernetPort и не используется.

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

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

Массив строк свободной формы, предоставляющий более подробное описание любых функций EthernetPort, указанных в массиве свойств 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.

ElementName

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

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

EnabledCapabilities

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

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

EnabledDefault

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

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

EnabledState

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

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

ErrorCleared

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

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

ErrorDescription

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

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

FullDuplex

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

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

HealthState

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

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

IdentifyingDescriptions

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

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

InstallDate

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

Дата добавления порта Ethernet на виртуальную машину. Это свойство наследуется от CIM_ManagedSystemElement.

InstanceID

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

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

LastErrorCode

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

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

LinkTechnology

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

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

Ethernet (2)

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 и всегда имеет значение 2 (ОК).

OtherEnabledCapabilities

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

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

OtherEnabledState

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

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

OtherIdentifyingInfo

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

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

OtherLinkTechnology

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

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

OtherNetworkPortType

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

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

OtherPortType

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

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

PermanentAddress

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

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

PortNumber

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

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

Тип порта

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

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

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.

Скорость

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

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

Состояние

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

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

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

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

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

StatusInfo

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

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

SupportedMaximumTransmissionUnit

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

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

SystemCreationClassName

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

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

SystemName

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

NetBIOS-имя системы компьютера размещения. Это свойство будет содержать идентификатор виртуальной машины в форме GUID . Это свойство наследуется от CIM_LogicalDevice.

TimeOfLastStateChange

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

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

TotalPowerOnHours

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

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

TransitioningToState

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

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

UsageRestriction

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

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

Примеры

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

Требования

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

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

CIM_EthernetPort
CIM_EthernetPort

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

Класс Msvm_SyntheticEthernetPort

Синтаксис

Члены

Методы

Свойства

Комментарии

Примеры

Требования

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

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

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