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

Состояние функции настраиваемого коммутатора

  • Статья

Платформа Hyper-V и интерфейс расширяемого коммутатора Hyper-V предоставляют инфраструктуру для получения пользовательских сведений о состоянии расширяемого коммутатора. Эти сведения называются сведениями о состоянии функции переключения .

Определения состояния настраиваемых функций коммутатора регистрируются на уровне управления WMI с помощью определений классов формата управляемых объектов (MOF). Помимо элементов структуры, определяющих атрибуты определения состояния компонента настраиваемого коммутатора, класс MOF должен также содержать следующее:

  • Идентификатор UUID, однозначно определяющий определение состояния функции настраиваемого коммутатора.

  • Идентификатор GUID, однозначно определяющий расширение расширяемого коммутатора. Этот GUID объявляется как квалификатор ExtensionId класса MOF и должен соответствовать значению записи NetCfgInstanceId , объявленной в INF-файле расширения.

  • Строка описательного имени класса. Имя поставщика должно быть включено в строку.

Ниже показан пример класса MOF для определения пользовательского состояния компонента расширяемого коммутатора.

#pragma namespace("\\\\.\\root\\virtualization\\v2")

[ Dynamic,
  UUID("B3E57D77-8E95-4977-97DE-524F8DAF03E4"),
  ExtensionId("5CBF81BE-5055-47CD-9055-A76B2B4E369E"), 
  Provider("VmmsWmiInstanceAndMethodProvider"), 
  InterfaceVersion("1"),
  InterfaceRevison("0"),
  Locale(0x409),
  Description(
   "Fabricam, Inc. Switch custom feature status description.") : Amended,
  DisplayName("Fabricam, Inc. Switch custom feature status friendly name.") : Amended]
class Fabrikam_CustomSwitchData  : Msvm_EthernetSwitchFeatureSettingData{
    [ Read,
       Write,
       WmiDataId(1),
       InterfaceVersion("1"),
       InterfaceRevision("0"),
       Description(
         "The current status of custom feature on this switch.") : Amended]
     uint32 CurrentStatus = 0 ;
};

Классы MOF для определения состояния пользовательского компонента расширяемого коммутатора регистрируются в репозитории CIM с помощью компилятора MOF (Mofcomp.exe). После регистрации класс MOF можно настроить с помощью командлетов PowerShell и программ приложений на основе WMI.

В следующем примере показаны команды, которые необходимо ввести для регистрации файла (Fabrikam_CustomSwitchData.mof), содержащего класс MOF для определения состояния настраиваемого переключателя.

net stop vmms
mofcomp -N:root\virtualization\v2 Fabrikam_CustomSwitchData.mof
net start vmms

Дополнительные сведения об использовании компилятора MOF см. в разделе Компиляция MOF-файла драйвера.

В следующем примере показано, как можно использовать определение состояния функции настраиваемого коммутатора для получения данных коммутатора. В этом примере класс MOF Fabrikam_CustomSwitchData используется для получения состояния коммутатора с именем TestSwitch. Расширение Fabrikam, Inc. включено в vSwitch "TestSwitch" и возвращает значение 123 для состояния.

PS C:\> $switchData = Get-VMSwitchExtensionSwitchData -SwitchName TestSwitch -FeatureId B3E57D77-8E95-4977-97DE-524F8DAF03E4
# Output the current value
PS C:\> $switchData$customSwitchData.Data.CurrentStatus
123

Дополнительные сведения о том, как расширяемые расширения коммутаторов управляют сведениями о состоянии функции коммутатора, см. в разделе Управление сведениями о состоянии компонента настраиваемого коммутатора.