Estado de la característica puerto 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 puerto de conmutador extensible. Esta información se conoce como información de estado de la característica de puerto .

Las definiciones de estado de características personalizadas para una propiedad de puerto de conmutador extensible de Hyper-V 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 puerto 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 de puerto 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 puerto de conmutador 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 ;
};

Las clases MOF para la definición de estado de característica personalizada de un puerto 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_CustomPortData.mof) que contiene la clase MOF para una definición de estado de característica de puerto personalizada.

net stop vmms
mofcomp -N:root\virtualization\v2 Fabrikam_CustomPortData.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 puerto personalizada para obtener datos de puerto. En este ejemplo, la clase FABRIKAM_CUSTOMPORTDATA MOF se usa para obtener el estado del puerto de una partición de Hyper-V denominada "TestVm". La extensión Fabrikam, Inc. está habilitada en el vSwitch "TestSwitch" y devuelve 123 para el estado.

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

Para obtener más información sobre cómo las extensiones de conmutador extensible administran la información de estado de la característica de puerto, consulte Administración de información de estado de características de puerto personalizado.