Funktionsstatus för anpassad växel

Det Hyper-V plattforms- och Hyper-V utökningsbara växelgränssnittet tillhandahåller infrastrukturen för att hämta anpassad statusinformation för en utökningsbar växel. Den här informationen kallas funktionsstatus för växel.

Funktionsstatusdefinitioner för anpassad växel registreras med WMI-hanteringslagret med hjälp av klassdefinitioner för hanterat objektformat (MOF). Förutom de strukturmedlemmar som definierar attributen för den anpassade växelns funktionsstatusdefinition måste MOF-klassen också innehålla följande:

• Ett UUID som unikt identifierar definitionen för funktionsstatus för anpassad växel.

• Ett GUID som unikt identifierar en utbyggbar switchförlängning. Det här GUID:et deklareras som ExtensionId-kvalificerare i MOF-klassen och måste matcha värdet för posten NetCfgInstanceId som deklareras i tilläggets INF-fil.

• En beskrivande klassnamnssträng. Namnet på leverantören måste ingå i strängen.

Följande visar ett exempel på en MOF-klass för en anpassad funktionsstatusdefinition för en utökningsbar växel.

#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-klasserna för definitionen av anpassad funktionsstatus för en utökningsbar växel registreras i CIM-lagringsplatsen (Common Information Model) med hjälp av MOF-kompilatorn (Mofcomp.exe). När den har registrerats kan MOF-klassen konfigureras via PowerShell-cmdletar och WMI-baserade program.

I följande exempel visas de kommandon som måste anges för att registrera en fil (Fabrikam_CustomSwitchData.mof) som innehåller MOF-klassen för en funktionsstatusdefinition för anpassad växel.

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

Mer information om hur du använder MOF-kompilatorn finns i Kompilera en drivrutins MOF-fil.

I följande exempel visas hur du kan använda funktionsstatusdefinitionen för anpassad växel för att hämta växeldata. I det här exemplet används klassen Fabrikam_CustomSwitchData MOF för att hämta växelstatus från en växel med namnet "TestSwitch". Tillägget Fabrikam, Inc. är aktiverat på vSwitch "TestSwitch" och returnerar 123 för statusen.

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

Mer information om hur utökningsbara växeltillägg hanterar statusinformation för växelfunktioner finns i Hantera statusinformation för anpassad växelfunktion.