Compartilhar via

Status do recurso do switch personalizado

A plataforma Hyper-V e Hyper-V interface de comutador extensível 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 do recurso de interruptor personalizado são registradas na camada de gerenciamento do WMI usando o 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:

  • Uma UUID que identifica exclusivamente a definição de status do recurso de comutador personalizado.

  • 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 descritiva de nome de classe. O nome do fornecedor deve ser incluído na cadeia de caracteres.

O exemplo a seguir mostra um exemplo de uma classe MOF para uma definição de status de recurso personalizado 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 definição de status de recurso personalizado 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 uma definição de status de recurso de comutador personalizado.

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 a definição de status do recurso de comutador personalizado para obter dados de comutador. Neste exemplo, a classe MOF Fabrikam_CustomSwitchData é utilizada para obter o estado de um comutador chamado "TestSwitch". A extensão Fabrikam, Inc. está habilitada no vSwitch "TestSwitch" e está retornando 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 comutador extensíveis gerenciam informações de status do recurso de comutador, consulte Gerenciando informações de status do recurso de comutador personalizado.

  • Last updated on