État de la fonctionnalité de commutateur personnalisé

La plateforme Hyper-V et l’interface de commutateur extensible Hyper-V fournissent l’infrastructure permettant d’obtenir des informations de status personnalisées pour un commutateur extensible. Ces informations sont appelées informations de status de fonctionnalité de basculement.

Les définitions status de fonctionnalités de commutateur personnalisées sont inscrites auprès de la couche de gestion WMI à l’aide de définitions de classe MOF (Managed Object Format). En plus des membres de structure qui définissent les attributs de la fonctionnalité de commutateur personnalisée status définition, la classe MOF doit également contenir les éléments suivants :

• UUID qui identifie de manière unique la fonctionnalité de commutateur personnalisée status définition.

• GUID qui identifie de manière unique l’extension de commutateur extensible. Ce GUID est déclaré comme qualificateur ExtensionId de la classe MOF et doit correspondre à la valeur de l’entrée NetCfgInstanceId déclarée dans le fichier INF de l’extension.

• Chaîne de nom de classe descriptive. Le nom du fournisseur doit être inclus dans la chaîne.

Voici un exemple de classe MOF pour une fonctionnalité personnalisée status définition d’un commutateur extensible.

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

Les classes MOF pour les fonctionnalités personnalisées status définition d’un commutateur extensible sont inscrites dans le référentiel CIM (Common Information Model) à l’aide du compilateur MOF (Mofcomp.exe). Une fois inscrite, la classe MOF peut être configurée via des applets de commande PowerShell et des programmes d’application WMI.

L’exemple suivant montre les commandes qui doivent être entrées pour inscrire un fichier (Fabrikam_CustomSwitchData.mof) qui contient la classe MOF pour une fonctionnalité de commutateur personnalisée status définition.

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

Pour plus d’informations sur l’utilisation du compilateur MOF, consultez Compilation d’un fichier MOF d’un pilote.

L’exemple suivant montre comment utiliser la fonctionnalité de commutateur personnalisée status définition pour obtenir des données de commutateur. Dans cet exemple, la classe MOF Fabrikam_CustomSwitchData est utilisée pour obtenir des status de commutateur à partir d’un commutateur nommé « TestSwitch ». L’extension Fabrikam, Inc. est activée sur le vSwitch « TestSwitch » et retourne la valeur 123 pour le status.

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

Pour plus d’informations sur la façon dont les extensions de commutateur extensibles gèrent les informations de status de fonctionnalité de commutateur, consultez Gestion des informations d’état des fonctionnalités de commutateur personnalisées.