Status do Recurso de Comutador Personalizado

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 um comutador extensível. Essas informações são conhecidas como informações de status do recurso switch.

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

• Um UUID que identifica exclusivamente o recurso de comutador personalizado 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 um comutador 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 recurso personalizado status definição de um comutador 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 aplicativo 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 um recurso de comutador personalizado status definição.

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

O exemplo a seguir mostra como você pode usar o recurso de comutador personalizado status definição para obter dados de comutador. Neste exemplo, a classe MOF Fabrikam_CustomSwitchData é usada para obter a opção status de um comutador chamado "TestSwitch". A extensão Fabrikam, Inc. está habilitada no vSwitch "TestSwitch" e está retornando 123 para o 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 comutador extensíveis gerenciam o recurso switch status informações, consulte Gerenciando informações de status de recurso de comutador personalizado.