Estado de la característica de conmutador personalizado

La plataforma hyper-V y la interfaz de conmutador extensible de Hyper-V proporcionan la infraestructura para obtener información de estado personalizada para un conmutador extensible. Esta información se conoce como información de estado de la característica switch .

Las definiciones de estado de características de conmutador personalizado se registran con la capa de administración de WMI mediante definiciones de clase de formato de objeto administrado (MOF). Además de los miembros de la estructura que definen los atributos de la definición de estado de la característica de conmutador personalizado, la clase MOF también debe contener lo siguiente:

• UUID que identifica de forma única la definición de estado de la característica del conmutador personalizado.

• GUID que identifica de forma única la extensión de conmutador extensible. Este GUID se declara como calificador ExtensionId de la clase MOF y debe coincidir con el valor de la entrada NetCfgInstanceId declarada en el archivo INF de la extensión.

• Cadena de nombre de clase descriptivo. El nombre del proveedor debe incluirse en la cadena.

A continuación se muestra un ejemplo de una clase MOF para una definición de estado de característica personalizada de un conmutador 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 ;
};

Las clases MOF para la definición de estado de característica personalizada de un conmutador extensible se registran en el repositorio del modelo de información común (CIM) mediante el compilador MOF (Mofcomp.exe). Una vez registrada, la clase MOF se puede configurar a través de cmdlets de PowerShell y programas de aplicaciones basados en WMI.

En el ejemplo siguiente se muestran los comandos que se deben escribir para registrar un archivo (Fabrikam_CustomSwitchData.mof) que contiene la clase MOF para una definición de estado de la característica de conmutador personalizado.

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

Para obtener más información sobre cómo usar el compilador MOF, vea Compilar un archivo MOF del controlador.

En el ejemplo siguiente se muestra cómo puede usar la definición de estado de la característica de conmutador personalizado para obtener datos de conmutador. En este ejemplo, la clase FABRIKAM_CUSTOMSWITCHDATA MOF se usa para obtener el estado del modificador de un conmutador denominado "TestSwitch". La extensión Fabrikam, Inc. está habilitada en el vSwitch "TestSwitch" y devuelve 123 para el estado.

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

Para obtener más información sobre cómo las extensiones de conmutador extensible administran la información sobre el estado de la característica del conmutador, consulte Managing Custom Switch Feature Status Information.