Classe Msvm_EmulatedEthernetPort
Representa um adaptador Ethernet emulado. Esse adaptador é usado quando uma máquina virtual não é capaz de executar a porta Ethernet sintética quando nenhum circuito integrado é instalado no convidado.
Observação
Essa classe não está disponível para máquinas virtuais de geração 2.
A sintaxe a seguir é um código MOF (Managed Object Format) simplificado e inclui todas as propriedades herdadas.
Sintaxe
[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_EmulatedEthernetPort : CIM_EthernetPort
{
string InstanceID;
string Caption = "Ethernet Port";
string Description = "Microsoft Emulated Ethernet Port";
string ElementName = "Legacy Network Adapter";
datetime InstallDate;
string Name = "Ethernet Port";
uint16 OperationalStatus[] = 2;
string StatusDescriptions[] = "OK";
string Status;
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_EmulatedEthernetPort";
string DeviceID = "Microsoft:GUID\device-specific data";
boolean PowerManagementSupported;
uint16 PowerManagementCapabilities[];
uint16 Availability;
uint16 StatusInfo;
uint32 LastErrorCode;
string ErrorDescription;
boolean ErrorCleared;
string OtherIdentifyingInfo[];
uint64 PowerOnHours;
uint16 TotalPowerOnHours;
string IdentifyingDescriptions[];
uint16 AdditionalAvailability[] = 6;
uint64 MaxQuiesceTime;
uint64 Speed = 1000000000;
uint64 MaxSpeed = 1000000000;
uint64 RequestedSpeed = 1000000000;
uint16 UsageRestriction = 4;
uint16 PortType = 1;
string OtherPortType = "Virtual Ethernet";
string OtherNetworkPortType;
uint16 PortNumber;
uint16 LinkTechnology = 2;
string OtherLinkTechnology;
string PermanentAddress;
string NetworkAddresses[];
boolean FullDuplex = True;
boolean AutoSense = True;
string SupportedMaximumTransmissionUnit = 1500;
uint64 ActiveMaximumTransmissionUnit = 1500;
uint32 MaxDataSize = 1500;
uint16 Capabilities[];
string CapabilityDescriptions[];
uint16 EnabledCapabilities[];
string OtherEnabledCapabilities[];
};
Membros
A classe Msvm_EmulatedEthernetPort tem estes tipos de membros:
Métodos
A classe Msvm_EmulatedEthernetPort 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 emulado. |
| 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_EmulatedEthernetPort tem essas propriedades.
-
ActiveMaximumTransmissionUnit
-
-
Tipo de dados: uint64
-
Tipo de acesso: Somente leitura
A MTU (unidade de transmissão máxima) ativa ou negociada que pode ter suporte. Essa propriedade é herdada de CIM_NetworkPort e sempre é definida como 1500.
-
-
AdditionalAvailability
-
-
Tipo de dados: matriz uint16
-
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 e é sempre definida como 6 ("Não Aplicável").
-
-
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 e é sempre definida como True.
-
-
Disponibilidade
-
-
Tipo de dados: uint16
-
Tipo de acesso: Somente leitura
A disponibilidade primária e status do dispositivo. Essa propriedade é herdada de CIM_LogicalDevice e é sempre definida como Null.
-
-
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 do 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
Funcionalidades da porta Ethernet. Essa propriedade é herdada de CIM_EthernetPort e não é usada.
-
-
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 qualquer um dos recursos de porta Ethernet indicados na matriz Capabilities . Observe que cada entrada dessa matriz está relacionada à entrada na matriz Capabilities localizada no mesmo índice. Essa propriedade é herdada de CIM_EthernetPort e não é usada.
-
-
Legenda
-
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
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 ou da subclasse usada na criação de uma instância. Quando usada com as outras propriedades de chave dessa classe, essa propriedade permite que todas as instâncias dessa classe e suas subclasses sejam identificadas exclusivamente. Essa propriedade é herdada de CIM_LogicalDevice e é sempre definida como "Msvm_EmulatedEthernetPort".
-
-
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 Emulada 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 usadas para nomear exclusivamente o dispositivo lógico. Essa propriedade é herdada de CIM_LogicalDevice e sempre é definida como "Dados específicos do dispositivo Microsoft:GUID\".
-
-
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 e é sempre definida como "Adaptador de Rede Herdado".
-
-
EnabledCapabilities
-
-
Tipo de dados: matriz uint16
-
Tipo de acesso: Somente leitura
Os recursos habilitados na lista de todos os com suporte, que são definidos na matriz Funcionalidades . Essa propriedade é herdada de CIM_EthernetPort, mas não é usada.
-
-
EnabledDefault
-
-
Tipo de dados: uint16
-
Tipo de acesso: Somente leitura
Configuração padrão ou de inicialização de um administrador para o estado habilitado 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. Essa propriedade é herdada de CIM_EnabledLogicalElement e é sempre definida como 5 ("Não Aplicável").
-
-
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 e 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 e 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 e é sempre definida como True.
-
-
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. 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 OtherIdentifyingInfo . Cada entrada dessa matriz está relacionada à entrada em OtherIdentifyingInfo que está localizada no mesmo índice. Essa propriedade é herdada de CIM_LogicalDevice e não é usada.
-
-
InstallDate
-
-
Tipo de dados: datetime
-
Tipo de acesso: Somente leitura
Um valor datetime que indica quando o objeto foi instalado. A falta de um valor não indica que o objeto não 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.
-
-
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 e não é usada.
-
-
LinkTechnology
-
-
Tipo de dados: uint16
-
Tipo de acesso: Somente leitura
Os tipos de links. Quando definida como 1 ("Outros"), a propriedade relacionada OtherLinkTechnology contém uma descrição de cadeia de caracteres do tipo de link. Essa propriedade é herdada de CIM_NetworkPort e é sempre definida como 2 ("Ethernet").
-
-
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 é herdada de CIM_LogicalDevice e não é usada.
-
-
Maxspeed
-
-
Tipo de dados: uint64
-
Tipo de acesso: Somente leitura
A largura de banda máxima da porta, em bits por segundo. Essa propriedade é herdada de CIM_LogicalPort e é sempre definida como 10000000000.
-
-
Nome
-
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
O rótulo pelo qual o objeto é conhecido. Quando subclasse, essa propriedade pode ser substituída para ser uma propriedade de chave. Essa propriedade é herdada de CIM_ManagedSystemElement e é sempre definida como "Porta Ethernet".
-
-
NetworkAddresses
-
-
Tipo de dados: matriz de cadeia de caracteres
-
Tipo de acesso: Somente leitura
Os endereços MAC Ethernet/802.3, formatados como doze dígitos hexadecimais (por exemplo, "010203040506"), com cada par representando um dos seis octetos do endereço MAC em ordem de bit canônica (o bit de endereço do grupo é encontrado no bit de ordem inferior do primeiro caractere da cadeia de caracteres). Essa propriedade é herdada de CIM_EthernetPort e não é usada.
-
-
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 elemento. Essa propriedade é herdada de CIM_ManagedSystemElement e é sempre definida 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 "Outros". Essa propriedade é herdada de CIM_EthernetPort e não é usada.
-
-
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 e não é usada.
-
-
OtherIdentifyingInfo
-
-
Tipo de dados: matriz de cadeia de caracteres
-
Tipo de acesso: Somente leitura
Todos os dados, além das informações de ID do dispositivo, que podem ser usados para identificar um dispositivo lógico. Por exemplo, você pode usar essa propriedade para manter o nome de exibição do sistema operacional para o dispositivo. Essa propriedade é herdada de CIM_LogicalDevice e 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, mas não é usada.
-
-
OtherNetworkPortType
-
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
Essa propriedade é herdada de CIM_NetworkPort e é definida como Null.
-
-
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 e é sempre definida como "Ethernet Virtual".
-
-
PermanentAddress
-
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
O endereço de rede codificado em uma porta. Esse endereço 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. Isso deverá ser deixado em branco se nenhum endereço codificado existir para o adaptador de rede. Essa propriedade é herdada de CIM_NetworkPort.
-
-
Número_da_porta
-
-
Tipo de dados: uint16
-
Tipo de acesso: Somente leitura
As portas de rede geralmente são numeradas em relação a um módulo lógico ou a um elemento de rede. Essa propriedade é herdada de CIM_NetworkPort.
Valor Significado - 0
A NIC não é emulada. - 1
A NIC é emulada. -
-
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_EthernetPort e é sempre definida como 1 ("Outros").
-
-
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 e 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 e não é usada.
-
-
PowerOnHours
-
-
Tipo de dados: uint64
-
Tipo de acesso: Somente leitura
O número de horas consecutivas em que este dispositivo foi alimentado, desde seu último ciclo de energia. Essa propriedade é herdada de CIM_LogicalDevice e 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
A largura de banda solicitada da porta, em bits por segundo. A largura de banda real é relatada em LogicalPort.Speed. Essa propriedade é herdada de CIM_LogicalPort e é sempre definida como 100000000000.
-
-
RequestedState
-
-
Tipo de dados: uint16
-
Tipo de acesso: Somente leitura
O último estado solicitado ou desejado para o serviço de gerenciamento. Quando EnabledState é definido como 5 ("Não Aplicável"), essa propriedade não tem nenhum significado. 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
A largura de banda atual da porta, em bits por segundo. Para portas que variam em largura de banda ou para aquelas em que nenhuma estimativa precisa pode ser feita, essa propriedade deve conter a largura de banda nominal. Essa propriedade é herdada de CIM_NetworkPort e é sempre definida como 100000000000.
-
-
Status
-
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
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 . As entradas nessa matriz são correlacionadas com aquelas no mesmo índice de matriz em OperationalStatus. Essa propriedade é herdada de CIM_ManagedSystemElement e está sempre definida como "OK".
-
-
StatusInfo
-
-
Tipo de dados: uint16
-
Tipo de acesso: Somente leitura
O estado do dispositivo lógico. Essa propriedade é herdada de CIM_LogicalDevice e não é usada.
-
-
SupportedMaximumTransmissionUnit
-
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
-
Qualificadores: unidades ("Bytes")
A MTU (unidade de transmissão máxima) que pode ser compatível, em bytes. Essa propriedade é herdada de CIM_NetworkPort e é sempre definida como 1500.
-
-
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
A ID da máquina virtual no formato GUID . Essa propriedade é herdada de CIM_LogicalDevice.
-
-
TimeOfLastStateChange
-
-
Tipo de dados: datetime
-
Tipo de acesso: Somente leitura
A data ou hora em que o EnabledState do elemento foi alterado pela última vez. Se o estado do elemento não tiver sido alterado e essa propriedade for preenchida, ela deverá ser definida como um valor de intervalo de 0. Se uma alteração de estado foi solicitada, mas rejeitada ou ainda não processada, a propriedade não deve ser atualizada. Essa propriedade é herdada de CIM_EnabledLogicalElement e não é usada.
-
-
TotalPowerOnHours
-
-
Tipo de dados: uint16
-
Tipo de acesso: Somente leitura
O número total de horas que este dispositivo foi alimentado. Essa propriedade é herdada de CIM_LogicalDevice e 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. 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 e sempre é definida como 4 ("Não Restrito").
-
Comentários
O acesso à classe Msvm_EmulatedEthernetPort 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 |
|
| DLL |
|