Status do recurso de porta personalizada

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

As definições de status de recursos personalizados para uma propriedade de porta de comutador extensível do Hyper-V são registradas com a camada de gerenciamento WMI usando definições de classe MOF (managed object format). Além dos membros da estrutura que definem os atributos do recurso de porta personalizada status definição, a classe MOF também deve conter o seguinte:

• Uma UUID que identifica exclusivamente o recurso de porta personalizada status definição.

• Um GUID que identifica exclusivamente a extensão de comutador extensível. Esse 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 de nome de classe descritiva. O nome do fornecedor deve ser incluído na cadeia de caracteres.

Veja a seguir um exemplo de uma classe MOF para um recurso personalizado status definição de uma porta de comutador 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 o recurso personalizado status definição de uma porta são registradas no repositório do 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 aplicativo 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 um recurso de porta personalizada status definição.

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 um arquivo MOF de driver.

O exemplo a seguir mostra como você pode usar o recurso de porta personalizada status definição para obter dados de porta. Neste exemplo, a classe MOF Fabrikam_CustomPortData é usada para obter status de porta de uma partição do Hyper-V chamada "TestVm". A extensão Fabrikam, Inc. está habilitada no vSwitch "TestSwitch" e está retornando 123 para o 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 comutador extensíveis gerenciam o recurso de porta status informações, consulte Gerenciando informações de status de recurso de porta personalizada.