Compartir a través de

Estado de la funcionalidad de interruptor personalizado

La plataforma Hyper-V y Hyper-V interfaz de conmutador extensible 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 característica de conmutador.

Las definiciones de los estados de las funcionalidades de conmutadores personalizados se registran en la capa de gestión de WMI utilizando definiciones de clase en formato de objeto gestionado (MOF). Además de los miembros de la estructura que definen los atributos de la definición de estado de la función de interruptor 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.

  • Un GUID que identifica de forma única la extensión del 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.

  • Una cadena de nombre de clase descriptiva. 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 siguiente ejemplo se muestra cómo se puede usar la definición de estado de la función del interruptor personalizado para obtener los datos del interruptor. En este ejemplo, la clase MOF Fabrikam_CustomSwitchData se emplea para obtener el estado del interruptor de un interruptor llamado "TestSwitch". La extensión Fabrikam, Inc. está habilitada en 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 las características del conmutador, consulte Administración de información de estado de características del conmutador personalizado.

  • Last updated on