Status do recurso do interruptor personalizado

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

As definições de estado da funcionalidade de switch personalizado são registadas na camada de gestão WMI usando definições de classe de formato de objeto gerenciado (MOF). Além dos membros da estrutura que definem os atributos da definição de status do recurso de comutador personalizado, a classe MOF também deve conter o seguinte:

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

• 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 mostra um exemplo de uma classe MOF para uma definição de status de recurso personalizado de um switch extensível.

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

As classes MOF para definição de status de recurso personalizado de um switch extensível 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_CustomSwitchData.mof) que contém a classe MOF para uma definição de status de recurso de switch personalizada.

net stop vmms
mofcomp -N:root\virtualization\v2 Fabrikam_CustomSwitchData.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 podes usar a definição de estado da função de interruptor personalizada para obter dados do interruptor. Neste exemplo, a classe MOF Fabrikam_CustomSwitchData é usada para obter o status do switch de um switch chamado "TestSwitch". A extensão da Fabrikam, Inc., está ativada no vSwitch "TestSwitch" e está a devolver 123 como status.

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 obter mais informações sobre como as extensões de switch gerem o estado das funcionalidades do switch, consulte Managing Custom Switch Feature Status Information.