Status des benutzerdefinierten Switchfeatures

Die Hyper-V-Plattform und die Hyper-V-Erweiterbare Switchschnittstelle stellen die Infrastruktur zum Abrufen benutzerdefinierter status Informationen für einen erweiterbaren Switch bereit. Diese Informationen werden als Switch-Feature status Informationen bezeichnet.

Benutzerdefinierte Switchfeatures status Definitionen werden mithilfe von MOF-Klassendefinitionen (Managed Object Format) bei der WMI-Verwaltungsebene registriert. Zusätzlich zu den Strukturmembern, die die Attribute des benutzerdefinierten Switchfeatures status Definition definieren, muss die MOF-Klasse auch Folgendes enthalten:

• Eine UUID, die das benutzerdefinierte Switchfeature status Definition eindeutig identifiziert.

• Eine GUID, die die erweiterbare Switcherweiterung eindeutig identifiziert. Diese GUID wird als ExtensionId-Qualifizierer der MOF-Klasse deklariert und muss mit dem Wert des NetCfgInstanceId-Eintrags übereinstimmen, der in der INF-Datei der Erweiterung deklariert ist.

• Eine beschreibende Klassennamenzeichenfolge. Der Name des Anbieters muss in der Zeichenfolge enthalten sein.

Im Folgenden finden Sie ein Beispiel für eine MOF-Klasse für ein benutzerdefiniertes Feature status Definition eines erweiterbaren Switches.

#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 ;
};

Die MOF-Klassen für benutzerdefinierte Features status Definition eines erweiterbaren Switches werden mithilfe des MOF-Compilers (Mofcomp.exe) im CIM-Repository (Common Information Model) registriert. Nach der Registrierung kann die MOF-Klasse über PowerShell-Cmdlets und WMI-basierte Anwendungsprogramme konfiguriert werden.

Das folgende Beispiel zeigt die Befehle, die eingegeben werden müssen, um eine Datei (Fabrikam_CustomSwitchData.mof) zu registrieren, die die MOF-Klasse für ein benutzerdefiniertes Switchfeature status Definition enthält.

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

Weitere Informationen zur Verwendung des MOF-Compilers finden Sie unter Kompilieren einer MOF-Datei des Treibers.

Das folgende Beispiel zeigt, wie Sie das benutzerdefinierte Switchfeature status Definition verwenden können, um Switchdaten abzurufen. In diesem Beispiel wird die Fabrikam_CustomSwitchData MOF-Klasse verwendet, um switch status von einem Switch mit dem Namen "TestSwitch" abzurufen. Die Fabrikam, Inc.-Erweiterung ist für den vSwitch "TestSwitch" aktiviert und gibt 123 für den status zurück.

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

Weitere Informationen dazu, wie erweiterbare Switcherweiterungen Switchfeatures status Informationen verwalten, finden Sie unter Verwalten von Informationen zum Featurestatus von benutzerdefinierten Switchen.