Partager via

État de la fonctionnalité de port personnalisé

  • Article

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 port de commutateur extensible. Ces informations sont appelées informations sur la fonctionnalité de port status.

Les définitions de status de fonctionnalités personnalisées pour une propriété de port de commutateur extensible Hyper-V sont inscrites auprès de la couche de gestion WMI à l’aide de définitions de classe MOF (Managed Object Format). Outre les membres de structure qui définissent les attributs de la fonctionnalité de port 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 port 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 port de commutateur extensible.

#pragma namespace("\\\\.\\root\\virtualization\\v2")

[ Dynamic,
  UUID("DAA0B7CC-74DB-41ef-8354-7002F9FA463E"),
  ExtensionId("5CBF81BE-5055-47CD-9055-A76B2B4E369E"), 
  Provider("VmmsWmiInstanceAndMethodProvider"), 
  InterfaceVersion("1"),
  InterfaceRevison("0"),
  Locale(0x409),
  Description("Fabricam, Inc. port custom feature status description.") : Amended,
  DisplayName("Fabricam, Inc.port custom feature status friendly name.") : Amended]
class Fabrikam_CustomPortData  : Msvm_EthernetPortData {
    [ Read,
       Write,
       WmiDataId(1),
      InterfaceVersion("1"),
      InterfaceRevision("0"),
       Description(
         "The current status of custom feature on this port.") : Amended]
     uint32 CurrentStatus = 0 ;
};

Les classes MOF pour la définition de fonctionnalité personnalisée status d’un port 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_CustomPortData.mof) qui contient la classe MOF d’une fonctionnalité de port personnalisée status définition.

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

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

L’exemple suivant montre comment utiliser la fonctionnalité de port personnalisée status définition pour obtenir des données de port. Dans cet exemple, la classe MOF Fabrikam_CustomPortData est utilisée pour obtenir des status de port à partir d’une partition Hyper-V nommée « TestVm ». L’extension Fabrikam, Inc. est activée sur le vSwitch « TestSwitch » et retourne 123 pour le status.

PS C:\> $portData = Get-VMSwitchExtensionPortData -VmName TestVm -FeatureId DAA0B7CC-74DB-41ef-8354-7002F9FA463E
# Output the current value
PS C:\> $portData.Data.CurrentStatus
123

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