Класс Msvm_EthernetSwitchPort

Статья
06/12/2023

Представляет порт на коммутаторе.

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

Синтаксис

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_EthernetSwitchPort : CIM_EthernetPort
{
  string   InstanceID;
  string   Caption = "Ethernet Switch Port";
  string   Description = "Microsoft Virtual Ethernet Switch Port";
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[] = 2;
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState = 2;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName = "Msvm_VirtualEthernetSwitch";
  string   SystemName;
  string   CreationClassName = "Msvm_EthernetSwitchPort";
  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[];
  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[];
  uint32   VMQOffloadUsage;
  uint32   IOVOffloadUsage;
};

Члены

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

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

Методы

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

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

Свойства

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

ActiveMaximumTransmissionUnit

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

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

AdditionalAvailability

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

Любые дополнительные сведения о доступности и состоянии устройства. Это свойство наследуется от 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 Reserved (.. )

Capabilities

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

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

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

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

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

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

Caption

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

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

CommunicationStatus

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

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

CreationClassName

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

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

Описание

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

Описание объекта. Это свойство наследуется от CIM_ManagedElement и всегда имеет значение "Microsoft Virtual Ethernet Switch 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
Тип доступа: только для чтения

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

Значение	Значение
Enabled 2	Элемент выполняется.
Отключено 3	Элемент отключен.

ErrorCleared

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

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

ErrorDescription

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

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

FullDuplex

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

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

HealthState

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

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

IdentifyingDescriptions

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

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

InstallDate

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

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

InstanceID

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

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

IOVOffloadUsage

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

Текущее использование разгрузки виртуализации ввода-вывода (IOV) на этом порту. Использование — это количество ресурсов IOV, используемых на порту.

LastErrorCode

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

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

LinkTechnology

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

Указывает тип технологии связи для порта. Если задано значение 1 (Other), свойство 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 (Другое). Это свойство наследуется от CIM_EthernetPort.

OtherEnabledState

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

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

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 (Other), связанное свойство 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, но не используется.

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

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

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

StatusInfo

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

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

SupportedMaximumTransmissionUnit

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

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

SystemCreationClassName

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

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

SystemName

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

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

TimeOfLastStateChange

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

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

TotalPowerOnHours

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

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

TransitioningToState

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

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

UsageRestriction

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

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

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

VMQOffloadUsage

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

Текущая очередь виртуальных машин (VMQ), разгружающая использование этого порта. Использование — это объем ресурсов VMQ, используемых в порте.

Требования

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

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