Stato della funzionalità porta personalizzata

L'interfaccia del commutatore estendibile Hyper-V e Hyper-V fornisce l'infrastruttura per ottenere informazioni di stato personalizzate per una porta di commutatore estendibile. Queste informazioni sono note come informazioni sullo stato della funzionalità di porta .

Le definizioni di stato delle funzionalità personalizzate per una proprietà porta estendibile Hyper-V vengono registrate con il livello di gestione WMI usando le definizioni di classe MOF (Managed Object Format). Oltre ai membri della struttura che definiscono gli attributi della definizione dello stato della funzionalità di porta personalizzata, la classe MOF deve contenere anche quanto segue:

• UUID che identifica in modo univoco la definizione dello stato della funzionalità di porta personalizzata.

• GUID che identifica in modo univoco l'estensione del commutatore estendibile. Questo GUID viene dichiarato come qualificatore ExtensionId della classe MOF e deve corrispondere al valore della voce NetCfgInstanceId dichiarata nel file INF dell'estensione.

• Stringa di nome della classe descrittiva. Il nome del fornitore deve essere incluso nella stringa.

Di seguito viene illustrato un esempio di classe MOF per una definizione di stato della funzionalità personalizzata di una porta di commutatore estendibile.

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

Le classi MOF per la definizione dello stato delle funzionalità personalizzate di una porta vengono registrate nel repository CIM (Common Information Model) usando il compilatore MOF (Mofcomp.exe). Dopo la registrazione, la classe MOF può essere configurata tramite i cmdlet di PowerShell e i programmi dell'applicazione basati su WMI.

Nell'esempio seguente vengono illustrati i comandi che devono essere immessi per registrare un file (Fabrikam_CustomPortData.mof) contenente la classe MOF per una definizione di stato della funzionalità di porta personalizzata.

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

Per altre informazioni sull'uso del compilatore MOF, vedere Compilazione di un file MOF di un driver.

Nell'esempio seguente viene illustrato come usare la definizione di stato della funzionalità di porta personalizzata per ottenere i dati della porta. In questo esempio viene usata la classe MOF Fabrikam_CustomPortData per ottenere lo stato della porta da una partizione Hyper-V denominata "TestVm". L'estensione Fabrikam, Inc. è abilitata nella vSwitch "TestSwitch" e restituisce 123 per lo stato.

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

Per altre informazioni sul modo in cui le estensioni del commutatore estendibile gestiscono le informazioni sullo stato delle funzionalità di porta, vedere Gestione delle informazioni sullo stato della funzionalità porta personalizzata.