Freigeben über

Status der benutzerdefinierten Switch-Funktionen

Die Hyper-V Plattform und Hyper-V erweiterbare Switchschnittstelle stellen die Infrastruktur bereit, um benutzerdefinierte Statusinformationen für einen erweiterbaren Switch abzurufen. Diese Informationen werden als Schaltfunktionen-Statusinformationen bezeichnet.

Benutzerdefinierte Schalter-Feature-Statusdefinitionen werden mit der WMI-Verwaltungsebene mithilfe von MOF-Klassendefinitionen (Managed Object Format) registriert. Zusätzlich zu den Strukturelementen, die die Attribute der benutzerdefinierten Switch-Featurestatusdefinition definieren, muss die MOF-Klasse auch Folgendes enthalten:

  • Eine UUID, die die benutzerdefinierte Funktion Switch-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 wird.

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

Im Folgenden sehen Sie ein Beispiel für eine MOF-Klasse für eine benutzerdefinierte Featurestatusdefinition 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 die Definition des benutzerdefinierten Featurestatus eines erweiterbaren Switches werden mithilfe des MOF-Compilers (Mofcomp.exe) im common Information Model (CIM)-Repository registriert. Nachdem sie registriert wurde, 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 eine benutzerdefinierte Switch-Featurestatusdefinition 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 die benutzerdefinierte Switch-Feature-Status-Definition verwenden können, um Switch-Daten abzurufen. In diesem Beispiel wird die Fabrikam_CustomSwitchData MOF-Klasse verwendet, um den Switchstatus von einem Switch mit dem Namen "TestSwitch" abzurufen. Die Fabrikam, Inc. Erweiterung ist auf dem 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 Switch-Featurestatusinformationen verwalten, finden Sie unter Managing Custom Switch Feature Status Information.

  • Last updated on