Status da Função de Porta Personalizada

A plataforma Hyper-V e a interface de switch extensível Hyper-V fornecem a infraestrutura para obter informações de status personalizadas para uma porta de switch extensível. Essas informações são conhecidas como informações de status da característica de porta.

As definições de estado de funcionalidade personalizadas para a propriedade de porta Hyper-V de um switch extensível são registadas na camada de gestão WMI utilizando definições de classe do formato de objeto gerido (MOF). Além dos membros da estrutura que definem os atributos da definição de status do recurso de porta personalizada, a classe MOF também deve conter o seguinte:

• Um UUID que identifica exclusivamente a definição de estado do recurso de porta personalizada.

• Um GUID que identifica de forma única a extensão de switch extensível. Este GUID é declarado como o qualificador ExtensionId da classe MOF e deve corresponder ao valor da entrada NetCfgInstanceId declarada no arquivo INF da extensão.

• Uma cadeia de caracteres descritiva do nome de classe. O nome do fornecedor deve ser incluído na cadeia de caracteres.

A seguir é mostrado um exemplo de uma classe MOF para uma definição de estado de funcionalidade personalizada de uma porta de switch extensível.

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

As classes MOF para definição de status de recurso personalizado de uma porta são registradas no repositório CIM (Common Information Model) usando o compilador MOF (Mofcomp.exe). Depois de registrada, a classe MOF pode ser configurada por meio de cmdlets do PowerShell e programas de aplicativos baseados em WMI.

O exemplo a seguir mostra os comandos que devem ser inseridos para registrar um arquivo (Fabrikam_CustomPortData.mof) que contém a classe MOF para uma definição de status de recurso de porta personalizada.

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

Para obter mais informações sobre como usar o compilador MOF, consulte compilando o arquivo MOF de um driver.

O exemplo a seguir mostra como você pode usar a definição de status do recurso de porta personalizada para obter dados de porta. Neste exemplo, a classe MOF Fabrikam_CustomPortData é usada para obter o status da porta de uma partição Hyper-V chamada "TestVm". A extensão da Fabrikam, Inc., está ativada no vSwitch "TestSwitch" e está a devolver 123 como status.

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

Para obter mais informações sobre como as extensões de switch extensíveis gerenciam as informações de status do recurso de porta, consulte Gerenciando informações de status de recurso de porta personalizadas.