État des fonctionnalités de commutateur personnalisé

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

Les définitions d’état des fonctionnalités de commutateur personnalisées sont enregistrées dans la couche de gestion WMI à l'aide de définitions de classes de format d'objets gérés (MOF). Outre les membres de la structure qui définissent les attributs de la définition d’état de fonctionnalité de commutateur personnalisé, la classe MOF doit également contenir les éléments suivants :

• Un UUID qui identifie de manière unique la définition de l'état de la fonctionnalité de commutateur personnalisé.

• Un 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.

L’exemple suivant montre un exemple de classe MOF pour une définition d’état de fonctionnalité personnalisée 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 la définition d’état des fonctionnalités personnalisées 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 basés sur 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 définition d’état de fonctionnalité de commutateur personnalisé.

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 du fichier MOF d’un pilote.

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

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 extensible gèrent les informations d’état des fonctionnalités de commutateur, consultez Gestion des informations sur l’état des fonctionnalités de commutateur personnalisé.