Compartilhar via

Classe Msvm_ExternalEthernetPort

  • Artigo

Representa uma porta Ethernet externa (adaptador de rede). Esses tipos de portas Ethernet dão às máquinas virtuais acesso à rede externa.

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_ExternalEthernetPort : CIM_EthernetPort
{
  string   InstanceID;
  string   Caption = "Ethernet Port";
  string   Description = "Microsoft External Ethernet Port";
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[] = 2;
  string   StatusDescriptions[] = "OK";
  string   Status = "OK";
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState = 5;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName = "Msvm_ComputerSystem";
  string   SystemName;
  string   CreationClassName = "Msvm_ExternalEthernetPort";
  string   DeviceID;
  boolean  PowerManagementSupported;
  uint16   PowerManagementCapabilities[];
  uint16   Availability;
  uint16   StatusInfo;
  uint32   LastErrorCode;
  string   ErrorDescription;
  boolean  ErrorCleared;
  string   OtherIdentifyingInfo[];
  uint64   PowerOnHours;
  uint64   TotalPowerOnHours;
  string   IdentifyingDescriptions[];
  string   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[];
  boolean  IsBound;
};

Membros

A classe Msvm_ExternalEthernetPort tem estes tipos de membros:

Métodos

A classe Msvm_ExternalEthernetPort 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_ExternalEthernetPort 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 de cadeia de caracteres

Tipo de acesso: Somente leitura

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

Auto

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Indica se a porta de rede é 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

Qualificadores: MaxLen (64)

Uma breve descrição do objeto. Essa propriedade é herdada de CIM_ManagedElement e é sempre definida como "Porta 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_ExternalEthernetPort".

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 Ethernet Externa da Microsoft".

DetailedStatus

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Complementa a propriedade PrimaryStatus com detalhes de 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 (Habilitado).

EnabledState

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Os estados habilitados e desabilitados de um elemento. Também pode indicar as transições entre esses estados solicitados. Por exemplo, desligar (4) e iniciar (10) são estados transitórios entre habilitados e desabilitados. Essa propriedade é herdada de CIM_EnabledLogicalElement.

Valor Significado
Desconhecido
0
Outros
1
Enabled
2
 O elemento é ou pode estar executando comandos, processará quaisquer comandos enfileirados e enfileirará novas solicitações.
Desabilitado
3
 O elemento não executará comandos e removerá novas solicitações.
Desligar
4
 O elemento está no processo de ir para um estado Desabilitado.
Não aplicável
5
 O elemento não dá suporte a ser habilitado ou desabilitado.
Habilitado, mas Offline
6
 O elemento pode estar concluindo comandos e descartará quaisquer novas solicitações.
Em teste
7
 O elemento está em um estado de teste.
Adiada
8
 O elemento pode estar concluindo comandos, mas enfileirará quaisquer novas solicitações.
Fechar
9
 O elemento está habilitado, mas em um modo restrito. O comportamento do elemento é semelhante ao estado Habilitado, mas processa apenas um conjunto restrito de comandos. Todas as outras solicitações são enfileiradas.
Iniciando
10
 O elemento está no processo de ir para um estado Enabled. Novas solicitações são enfileiradas.
DMTF Reservado
11 32767
 Reservado.
Fornecedor Reservado
32768 65535
 Reservado.

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. Esse atributo expressa a integridade desse elemento, mas não necessariamente a de seus subcomponentes. Os valores possíveis são de 0 a 30, em que 5 significa que o elemento está totalmente íntegro e 30 significa que o elemento é completamente não funcional. 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.

Isbound

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Se essa propriedade for True, essa porta Ethernet poderá ser conectada aos comutadores e, portanto, poderá fornecer conectividade a uma máquina virtual. Se essa propriedade for False, essa porta Ethernet não estará sendo usada pela arquitetura de rede da máquina virtual.

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 quadro (8)

Infravermelho (9)

BlueTooth (10)

LAN sem fio (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 da 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 EnabledState for qualquer valor diferente de 1. Essa propriedade é herdada de CIM_EnabledLogicalElement.

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

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 relacionada OtherPortType 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 leitura

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.

"OK"

OKEY

Erro

Degradado

Desconhecido

Falha de Pred

Começando

Parar

Serviço

Estressado

NonRecover

Sem Contato

Mensagens perdidas

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 e cada elemento de matriz é sempre definido como "OK".

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_ComputerSystem".

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 "Não restrito". Essa propriedade é herdada de CIM_LogicalPort.

Desconhecido (0)

Somente front-end (2)

Somente back-end (3)

Não restrito (4)

Comentários

O acesso à classe Msvm_ExternalEthernetPort pode ser restrito pela Filtragem UAC. Para obter mais informações, consulte Controle de conta de usuário e WMI.

Exemplos

Consulte Consultando objetos de rede.

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

Confira também

CIM_EthernetPort

CIM_EthernetPort