Compartilhar via

Classe Msvm_EthernetSwitchPort

  • Artigo

Representa uma porta no comutador.

A sintaxe a seguir é o código MOF (Managed Object Format) simplificado e inclui todas as propriedades herdadas.

Sintaxe

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_EthernetSwitchPort : CIM_EthernetPort
{
  string   InstanceID;
  string   Caption = "Ethernet Switch Port";
  string   Description = "Microsoft Virtual Ethernet Switch Port";
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[] = 2;
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState = 2;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName = "Msvm_VirtualEthernetSwitch";
  string   SystemName;
  string   CreationClassName = "Msvm_EthernetSwitchPort";
  string   DeviceID;
  boolean  PowerManagementSupported;
  uint16   PowerManagementCapabilities[];
  uint16   Availability;
  uint16   StatusInfo;
  uint32   LastErrorCode;
  string   ErrorDescription;
  boolean  ErrorCleared;
  string   OtherIdentifyingInfo[];
  uint64   PowerOnHours;
  uint64   TotalPowerOnHours;
  string   IdentifyingDescriptions[];
  uint16   AdditionalAvailability[];
  uint64   MaxQuiesceTime;
  uint64   Speed;
  uint64   MaxSpeed;
  uint64   RequestedSpeed;
  uint16   UsageRestriction;
  uint16   PortType;
  string   OtherPortType;
  string   OtherNetworkPortType;
  uint16   PortNumber;
  uint16   LinkTechnology;
  string   OtherLinkTechnology;
  string   PermanentAddress;
  string   NetworkAddresses[];
  boolean  FullDuplex;
  boolean  AutoSense;
  uint64   SupportedMaximumTransmissionUnit;
  uint64   ActiveMaximumTransmissionUnit;
  uint32   MaxDataSize;
  uint16   Capabilities[];
  string   CapabilityDescriptions[];
  uint16   EnabledCapabilities[];
  string   OtherEnabledCapabilities[];
  uint32   VMQOffloadUsage;
  uint32   IOVOffloadUsage;
};

Membros

A classe Msvm_EthernetSwitchPort tem esses tipos de membros:

Métodos

A classe Msvm_EthernetSwitchPort tem esses métodos.

Método Descrição
EnableDevice Não há suporte para o método.
OnlineDevice Não há suporte para o método.
QuiesceDevice Não há suporte para o método.
RequestStateChange Solicita uma alteração de estado.
Redefinir Redefine o dispositivo virtual.
RestoreProperties Não há suporte para o método.
SaveProperties Não há suporte para o método.
SetPowerState Não há suporte para o método.

Propriedades

A classe Msvm_EthernetSwitchPort tem essas propriedades.

ActiveMaximumTransmissionUnit

Tipo de dados: uint64

Tipo de acesso: Somente leitura

Qualificadores: unidades ("Bytes")

A MTU (unidade de transmissão máxima) ativa ou negociada que pode ter suporte, em bytes. Essa propriedade é herdada de CIM_NetworkPort.

AdditionalAvailability

Tipo de dados: matriz uint16

Tipo de acesso: Somente leitura

Qualquer disponibilidade adicional e status do dispositivo. Essa propriedade é herdada de CIM_LogicalDevice, mas não é usada.

Auto

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Indica se a porta é capaz de determinar automaticamente a velocidade ou outras características de comunicação da mídia de rede anexada. Essa propriedade é herdada de CIM_NetworkPort.

Disponibilidade

Tipo de dados: uint16

Tipo de acesso: Somente leitura

A disponibilidade primária e status do dispositivo. Essa propriedade é herdada de CIM_LogicalDevice, mas não é usada.

AvailableRequestedStates

Tipo de dados: matriz uint16

Tipo de acesso: Somente leitura

Indica os valores possíveis para o parâmetro RequestedState do método RequestStateChange usado para iniciar uma alteração de estado. Os valores listados serão um subconjunto dos valores contidos na propriedade RequestedStatesSupported da instância associada de CIM_EnabledLogicalElementCapabilities, em que os valores selecionados são uma função do estado atual do CIM_EnabledLogicalElement. Essa propriedade poderá ser não Null se uma implementação for capaz de anunciar o conjunto de valores possíveis como uma função do estado atual. Essa propriedade será Null se uma implementação não puder determinar o conjunto de valores possíveis como uma função do estado atual.

Essa propriedade é herdada de CIM_EnabledLogicalElement.

Habilitado (2)

Desabilitado (3)

Desligar (4)

Offline (6)

Teste (7)

Adiar (8)

Quiesce (9)

Reinicialização (10)

Redefinir (11)

DMTF Reservado (.. )

Funcionalidades

Tipo de dados: matriz uint16

Tipo de acesso: Somente leitura

Uma matriz que especifica os recursos da porta. Essa propriedade é herdada de CIM_EthernetPort.

Desconhecido (0)

Outros (1)

AlertOnLan (2)

WakeOnLan (3)

FailOver (4)

LoadBalancing (5 )

CapabilityDescriptions

Tipo de dados: matriz de cadeia de caracteres

Tipo de acesso: Somente leitura

Uma matriz de cadeias de caracteres de forma livre que fornece explicações mais detalhadas para os recursos de porta contidos na matriz Capabilities . Cada entrada dessa matriz está relacionada à entrada correspondente na matriz Capabilities localizada no mesmo índice. Essa propriedade é herdada de CIM_EthernetPort.

Legenda

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Uma breve descrição do objeto. Essa propriedade é herdada da classe CIM_ManagedElement e é sempre definida como "Porta de Comutador Ethernet".

CommunicationStatus

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Indica a capacidade da instrumentação de se comunicar com o elemento gerenciado subjacente. Um valor Null indica que essa propriedade não está implementada. Essa propriedade é herdada de CIM_ManagedSystemElement.

CreationClassName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

O nome da classe de criação do sistema de escopo. Essa propriedade é herdada de CIM_LogicalDevice e é sempre definida como "Msvm_EthernetSwitchPort".

Descrição

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Uma descrição do objeto . Essa propriedade é herdada de CIM_ManagedElement e é sempre definida como "Porta do Comutador Ethernet Virtual da Microsoft".

DetailedStatus

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Complementa a propriedade PrimaryStatus com detalhes status adicionais. Um valor Null indica que essa propriedade não está implementada. Essa propriedade é herdada de CIM_ManagedSystemElement.

Deviceid

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Um endereço ou outras informações de identificação para nomear exclusivamente o dispositivo lógico. Essa propriedade é herdada de CIM_LogicalDevice.

ElementName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Um nome de exibição para o objeto . Essa propriedade é herdada de CIM_ManagedElement.

EnabledCapabilities

Tipo de dados: matriz uint16

Tipo de acesso: Somente leitura

Especifica quais recursos estão habilitados na lista de todos os recursos com suporte na matriz Funcionalidades . Essa propriedade é herdada de CIM_EthernetPort.

Desconhecido (0)

Outros (1)

AlertOnLan (2)

WakeOnLan (3)

FailOver (4)

LoadBalancing (5 )

EnabledDefault

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Configuração padrão ou de inicialização de um administrador para a propriedade EnabledState de um elemento. Essa propriedade é herdada de CIM_EnabledLogicalElement e é sempre definida como 2 (Habilitada).

EnabledState

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Os estados habilitados e desabilitados de um elemento. Essa propriedade é herdada de CIM_EnabledLogicalElement e será um dos valores a seguir.

Valor Significado
Enabled
2
 O elemento está em execução.
Desabilitado
3
 O elemento está desativado.

ErrorCleared

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Indica se o erro relatado em LastErrorCode agora está limpo. Essa propriedade é herdada de CIM_LogicalDevice, mas não é usada.

ErrorDescription

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Uma cadeia de caracteres que fornece mais informações sobre o erro registrado em LastErrorCode e informações sobre as ações corretivas que podem ser executadas. Essa propriedade é herdada de CIM_LogicalDevice, mas não é usada.

FullDuplex

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Indica se a porta está operando no modo duplex completo. Essa propriedade é herdada de CIM_NetworkPort.

HealthState

Tipo de dados: uint16

Tipo de acesso: Somente leitura

A integridade atual do elemento. Essa propriedade é herdada de CIM_ManagedSystemElement e é sempre definida como 5 (OK).

IdentifyingDescriptions

Tipo de dados: matriz de cadeia de caracteres

Tipo de acesso: Somente leitura

Uma matriz de cadeias de caracteres de forma livre que fornecem explicações e detalhes por trás das entradas na matriz de propriedades OtherIdentifyingInfo . Essa propriedade é herdada de CIM_LogicalDevice, mas não é usada.

InstallDate

Tipo de dados: datetime

Tipo de acesso: Somente leitura

A data e a hora em que o objeto foi instalado. Essa propriedade não precisa de um valor para indicar que o objeto está instalado. Essa propriedade é herdada de CIM_ManagedSystemElement.

InstanceID

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: Chave

Identifica exclusivamente uma instância dessa classe. Essa propriedade é herdada de CIM_ManagedElement.

IOVOffloadUsage

Tipo de dados: uint32

Tipo de acesso: Somente leitura

O uso de descarregamento de IOV (virtualização de E/S) atual nessa porta. O uso é a quantidade de recursos IOV em uso na porta.

LastErrorCode

Tipo de dados: uint32

Tipo de acesso: Somente leitura

O último código de erro relatado pelo dispositivo lógico. Essa propriedade é herdada de CIM_LogicalDevice, mas não é usada.

LinkTechnology

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Especifica o tipo de tecnologia de link para a porta. Quando definida como 1 (Outros), a propriedade OtherLinkTechnology contém uma descrição de cadeia de caracteres do tipo de link. Essa propriedade é herdada de CIM_NetworkPort.

Desconhecido (0)

Outros (1)

Ethernet (2)

IB (3)

FC (4)

FDDI (5)

CAIXA ELETRÔNICO (6)

Anel de Token (7)

Retransmissão de Quadros (8)

Infravermelho (9)

BlueTooth (10)

WIRELESS LAN (11 )

MaxDataSize

Tipo de dados: uint32

Tipo de acesso: Somente leitura

O tamanho máximo do campo INFO (não MAC) que será recebido ou transmitido. Essa propriedade é herdada de CIM_EthernetPort e é sempre definida como 1500.

MaxQuiesceTime

Tipo de dados: uint64

Tipo de acesso: Somente leitura

Essa propriedade foi substituída. Essa propriedade é herdada de CIM_LogicalDevice, mas não é usada.

Maxspeed

Tipo de dados: uint64

Tipo de acesso: Somente leitura

Qualificadores: Unidades ("Bits por Segundo")

A largura de banda máxima da porta, em bits por segundo. Essa propriedade é herdada de CIM_LogicalPort.

Nome

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

O rótulo pelo qual o objeto é conhecido. Essa propriedade é herdada de CIM_ManagedSystemElement.

NetworkAddresses

Tipo de dados: matriz de cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MaxLen ( 64 )

Uma matriz de cadeias de caracteres que contêm os endereços MAC para a porta. Essa propriedade é herdada de CIM_NetworkPort.

OperatingStatus

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Fornece informações de status atuais para a condição operacional do elemento e pode ser usado para fornecer mais detalhes em relação ao valor da propriedade EnabledState. Um valor Null indica que essa propriedade não está implementada. Essa propriedade é herdada de CIM_ManagedSystemElement.

OperationalStatus

Tipo de dados: matriz uint16

Tipo de acesso: Somente leitura

Os status atuais do objeto. Essa propriedade é herdada de CIM_ManagedSystemElement e cada elemento de matriz é sempre definido como 2 (OK).

OtherEnabledCapabilities

Tipo de dados: matriz de cadeia de caracteres

Tipo de acesso: Somente leitura

Uma matriz de cadeias de caracteres de forma livre que fornece explicações mais detalhadas para qualquer um dos recursos habilitados especificados como 1 (Outros). Essa propriedade é herdada de CIM_EthernetPort.

OtherEnabledState

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Uma cadeia de caracteres que descreve o estado habilitado ou desabilitado do elemento quando a propriedade EnabledState é definida como 1 (Outros). Essa propriedade deve ser definida como Null quando a propriedade EnabledState for qualquer valor diferente de 1. Essa propriedade é herdada de CIM_EnabledLogicalElement e é sempre definida como Null.

OtherIdentifyingInfo

Tipo de dados: matriz de cadeia de caracteres

Tipo de acesso: Somente leitura

Quaisquer dados adicionais, além das informações de ID do dispositivo, que podem ser usados para identificar um dispositivo lógico. Essa propriedade é herdada de CIM_LogicalDevice, mas não é usada.

OtherLinkTechnology

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Um valor de cadeia de caracteres que descreve LinkTechnology quando ele é definido como 1, (Outros). Essa propriedade é herdada de CIM_NetworkPort.

OtherNetworkPortType

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

O uso dessa propriedade foi preterido em vez da propriedade PortType . Essa propriedade é herdada de CIM_NetworkPort.

OtherPortType

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Descreve o tipo de módulo, quando PortType é definido como 1 (Outros). Essa propriedade é herdada de CIM_LogicalPort.

PermanentAddress

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MaxLen ( 64 )

O endereço de rede codificado em uma porta. Esse endereço embutido em código pode ser alterado usando uma atualização de firmware ou uma configuração de software. Quando essa alteração é feita, o campo deve ser atualizado ao mesmo tempo. Essa propriedade deverá ser Null se não houver nenhum endereço codificado para o adaptador de rede. Essa propriedade é herdada de CIM_NetworkPort.

Número_da_porta

Tipo de dados: uint16

Tipo de acesso: Somente leitura

O número da porta. Essa propriedade é herdada de CIM_NetworkPort.

Porttype

Tipo de dados: uint16

Tipo de acesso: Somente leitura

O modo específico que está atualmente habilitado para a porta. Quando definida como 1 (Outros), a propriedade OtherPortType relacionada contém uma descrição de cadeia de caracteres do tipo de porta. Essa propriedade é herdada de CIM_LogicalPort.

Desconhecido (0)

Outros (1)

//50 Cobre 10BaseT (50)

10-100BaseT (51)

100BaseT (52)

1000BaseT (53)

2500BaseT (54)

10GBaseT (55)

10GBase-CX4 (56)

//100 Fibre 100Base-FX (100)

100Base-SX (101)

1000Base-SX (102)

1000Base-LX (103)

1000Base-CX (104)

10GBase-SR (105)

10GBase-SW (106)

10GBase-LX4 (107)

10GBase-LR (108)

10GBase-LW (109)

10GBase-ER (110)

10GBase-EW (111)

Fornecedor Reservado (16000..65535 )

PowerManagementCapabilities

Tipo de dados: matriz uint16

Tipo de acesso: Somente leitura

Os recursos de gerenciamento de energia do dispositivo. Essa propriedade é herdada de CIM_LogicalDevice, mas não é usada.

PowerManagementSupported

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Indica se o dispositivo pode ser gerenciado por energia. Essa propriedade é herdada de CIM_LogicalDevice, mas não é usada.

PowerOnHours

Tipo de dados: uint64

Tipo de acesso: Somente leitura

O número de horas consecutivas em que este dispositivo foi ligado desde seu último ciclo de energia. Essa propriedade é herdada de CIM_LogicalDevice, mas não é usada.

PrimaryStatus

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Fornece informações de status de alto nível. Essa propriedade deve ser usada em conjunto com a propriedade DetailedStatus para fornecer informações de status de integridade detalhadas e de alto nível para o elemento e seus subcomponentes. Um valor Null indica que essa propriedade não está implementada. Essa propriedade é herdada de CIM_ManagedSystemElement.

RequestedSpeed

Tipo de dados: uint64

Tipo de acesso: somente gravação

Qualificadores: Unidades ("Bits por Segundo")

A largura de banda solicitada da porta, em bits por segundo. A largura de banda real é relatada na propriedade Speed . Essa propriedade é herdada de CIM_LogicalPort.

RequestedState

Tipo de dados: uint16

Tipo de acesso: Somente leitura

O último estado solicitado ou desejado para o elemento. Essa propriedade é herdada de CIM_EnabledLogicalElement e é sempre definida como 12 (Não Aplicável).

Velocidade

Tipo de dados: uint64

Tipo de acesso: Somente leitura

Qualificadores: Unidades ("Bits por Segundo")

A largura de banda da porta, em bits por segundo. Essa propriedade é herdada de CIM_LogicalPort.

Status

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

O status atual do objeto . Essa propriedade é herdada de CIM_ManagedSystemElement, mas não é usada.

StatusDescriptions

Tipo de dados: matriz de cadeia de caracteres

Tipo de acesso: Somente leitura

Cadeias de caracteres que descrevem os vários valores de matriz OperationalStatus . Essa propriedade é herdada de CIM_ManagedSystemElement.

StatusInfo

Tipo de dados: uint16

Tipo de acesso: Somente leitura

O estado atual do dispositivo lógico. Essa propriedade é herdada de CIM_LogicalDevice, mas não é usada.

SupportedMaximumTransmissionUnit

Tipo de dados: uint64

Tipo de acesso: Somente leitura

Qualificadores: unidades ("Bytes")

A MTU (unidade de transmissão máxima) que pode ter suporte, em bytes. Essa propriedade é herdada de CIM_NetworkPort.

SystemCreationClassName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

O nome da classe de criação do sistema de escopo. Essa propriedade é herdada de CIM_LogicalDevice e é sempre definida como "Msvm_VirtualEthernetSwitch".

Systemname

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

O nome do sistema de escopo. Essa propriedade é herdada de CIM_LogicalDevice.

TimeOfLastStateChange

Tipo de dados: datetime

Tipo de acesso: Somente leitura

A data ou hora em que o estado habilitado do elemento foi alterado pela última vez. Essa propriedade é herdada de CIM_EnabledLogicalElement e é sempre definida como Null.

TotalPowerOnHours

Tipo de dados: uint64

Tipo de acesso: Somente leitura

O número total de horas que este dispositivo foi alimentado. Essa propriedade é herdada de CIM_LogicalDevice, mas não é usada.

TransitioningToState

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Indica o estado de destino para o qual a instância está em transição. Essa propriedade é herdada de CIM_EnabledLogicalElement, mas não é usada.

UsageRestriction

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Em algumas circunstâncias, uma porta lógica pode ser identificável como uma porta de front-end ou back-end. Um exemplo dessa situação seria uma matriz de armazenamento que pode ter portas de back-end para se comunicar com unidades de disco e portas de front-end para se comunicar com hosts. Se não houver nenhuma restrição sobre o uso da porta, o valor deverá ser definido como 4 (Não restrito). Essa propriedade é herdada de CIM_LogicalPort.

Desconhecido (0)

Somente front-end (2)

Somente back-end (3)

Não restrito (4 )

VMQOffloadUsage

Tipo de dados: uint32

Tipo de acesso: Somente leitura

A VMQ (fila de máquina virtual) atual descarregando o uso nessa porta. O uso é a quantidade de recursos VMQ em uso na porta.

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows Server 2012 [somente aplicativos da área de trabalho]
Namespace
 Root\Virtualization\V2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe