Stato della funzionalità opzione personalizzata

La piattaforma Hyper-V e l'interfaccia del commutatore estendibile Hyper-V forniscono l'infrastruttura per ottenere informazioni sullo stato personalizzate per un commutatore estendibile. Queste informazioni sono note come informazioni sullo stato delle funzionalità switch .

Le definizioni di stato delle funzionalità del commutatore personalizzato vengono registrate con il livello di gestione WMI usando definizioni di classe MOF (Managed Object Format). Oltre ai membri della struttura che definiscono gli attributi della definizione dello stato della funzionalità del commutatore personalizzato, la classe MOF deve contenere anche quanto segue:

• UUID che identifica in modo univoco la definizione dello stato della funzionalità del commutatore personalizzato.

• 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 un commutatore estendibile.

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

Le classi MOF per la definizione dello stato delle funzionalità personalizzate di un commutatore estendibile 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_CustomSwitchData.mof) che contiene la classe MOF per una definizione di stato della funzionalità del commutatore personalizzato.

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

Per altre informazioni su come usare il compilatore MOF, vedere Compilazione di un file MOF di un driver.

Nell'esempio seguente viene illustrato come usare la definizione dello stato della funzionalità del commutatore personalizzato per ottenere dati switch. In questo esempio viene usata la classe MOF Fabrikam_CustomSwitchData per ottenere lo stato del commutatore da un'opzione denominata "TestSwitch". L'estensione Fabrikam, Inc. è abilitata nel vSwitch "TestSwitch" e restituisce 123 per lo stato.

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

Per altre informazioni su come le estensioni del commutatore estendibile gestiscono le informazioni sullo stato delle funzionalità del commutatore, vedere Gestione delle informazioni sullo stato delle funzionalità del commutatore personalizzato.