classe Msvm_EmulatedEthernetPortSettingData

Representa o estado configurado de um adaptador Ethernet emulado.

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_EmulatedEthernetPortSettingData : CIM_EthernetPortAllocationSettingData
{
  string  Caption = "Ethernet Port";
  string  Description = "Settings for the Microsoft Emulated Ethernet Port";
  string  InstanceID = "Microsoft:VMID\VDID\device-specific-data";
  string  ElementName = "Ethernet Port";
  uint16  ResourceType = 10;
  string  OtherResourceType;
  string  ResourceSubType = "Microsoft Emulated Ethernet Port";
  string  PoolID;
  uint16  ConsumerVisibility = 3;
  string  HostResource[];
  string  AllocationUnits = "Ports";
  uint64  VirtualQuantity = 1;
  uint64  Reservation = 1;
  uint64  Limit = 1;
  uint32  Weight = 0;
  boolean AutomaticAllocation = True;
  boolean AutomaticDeallocation = True;
  string  Parent;
  string  Connection[];
  string  Address;
  uint16  MappingBehavior;
  string  AddressOnParent;
  string  VirtualQuantityUnits = "count";
  uint16  DesiredVLANEndpointMode;
  string  OtherEndpointMode;
  boolean StaticMacAddress = TRUE;
  boolean ClusterMonitored = TRUE;
};

Membros

A classe Msvm_EmulatedEthernetPortSettingData tem estes tipos de membros:

Propriedades

A classe Msvm_EmulatedEthernetPortSettingData tem essas propriedades.

Endereço

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

O endereço do recurso. Por exemplo, o endereço MAC de uma porta Ethernet. Essa propriedade é herdada de CIM_ResourceAllocationSettingData.

Essa é uma propriedade somente leitura, mas pode ser alterada usando o método ModifyResourceSettings da classe Msvm_VirtualSystemManagementService .

AddressOnParent

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Descreve o endereço desse recurso no contexto do pai. As propriedades Parent e AddressOnParent são usadas para descrever a relação do controlador, bem como a ordenação de dispositivos em um controlador. Essa propriedade é herdada de CIM_ResourceAllocationSettingData.

AllocationUnits

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

As unidades de alocação usadas pelas propriedades Reserva e Limite . Essa propriedade é herdada de CIM_ResourceAllocationSettingData e é sempre definida como "Portas".

AutomaticAllocation

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Indica se o recurso será alocado automaticamente. Essa propriedade é herdada de CIM_ResourceAllocationSettingData e é sempre definida como True.

AutomaticDeallocation

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Indica se o recurso será desalocado automaticamente. Essa propriedade é herdada de CIM_ResourceAllocationSettingData e é sempre definida como True.

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

ClusterMonitorado

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Indica se esse adaptador ethernet é monitorado por um cluster. Essa propriedade usa como padrão true se não estiver configurada.

Essa é uma propriedade somente leitura, mas pode ser alterada usando o método ModifyResourceSettings da classe Msvm_VirtualSystemManagementService .

Windows 8.1: esse valor não tem suporte até Windows 8.1 e Windows Server 2012 R2.

Conexão

Tipo de dados: matriz de cadeia de caracteres

Tipo de acesso: Somente leitura

A coisa à qual esse recurso está conectado. Por exemplo, uma rede nomeada ou porta de comutador. Essa propriedade é herdada de CIM_ResourceAllocationSettingData.

Essa é uma propriedade somente leitura, mas pode ser alterada usando o método ModifyResourceSettings da classe Msvm_VirtualSystemManagementService .

ConsumerVisibility

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Descreve a visibilidade dos consumidores para o recurso alocado. Essa propriedade é herdada de CIM_ResourceAllocationSettingData e sempre é definida como 3 (Virtualizada).

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 "Configurações da Porta Ethernet Emulada da Microsoft".

DesiredVLANEndpointMode

Tipo de dados: uint16

Tipo de acesso: Somente leitura

O modo de configuração desejado para o ponto de extremidade VLAN. Essa propriedade é usada para definir o valor inicial da propriedade OperationalEndpointMode na instância de Msvm_VLANEndpoint classe associada à porta Ethernet de destino. Consulte a propriedade OperationalEndpointMode da classe Msvm_VLANEndpoint para obter valores possíveis. Essa propriedade é herdada de CIM_EthernetPortAllocationSettingData.

ElementName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

O nome de exibição configurável pelo usuário para o dispositivo ao qual esta instância RASD está associada. Essa propriedade é herdada de CIM_SettingData e é definida como "Porta Ethernet". Alterar essa propriedade alterará o nome do elemento do derivado do dispositivo lógico associado.

Essa é uma propriedade somente leitura, mas pode ser alterada usando o método ModifyResourceSettings da classe Msvm_VirtualSystemManagementService .

HostResource

Tipo de dados: matriz de cadeia de caracteres

Tipo de acesso: Somente leitura

Essa propriedade é herdada de CIM_ResourceAllocationSettingData e é sempre definida como Null.

InstanceID

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Dentro do escopo do namespace de instanciação, InstanceID identifica de forma opaca e exclusivamente uma instância dessa classe. Essa propriedade é herdada de CIM_SettingData e é sempre definida como "Microsoft:VMID\VDID\device-specific-data".

Limite

Tipo de dados: uint64

Tipo de acesso: Somente leitura

O limite superior ou a quantidade máxima de recursos que serão concedidos para essa alocação. Essa propriedade é herdada de CIM_ResourceAllocationSettingData e é sempre definida como 1.

MappingBehavior

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Especifica como esse recurso é mapeado para recursos subjacentes. Essa propriedade é herdada de CIM_ResourceAllocationSettingData e é sempre definida como Null.

OtherEndpointMode

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Uma cadeia de caracteres que descreve o tipo de modelo de ponto de extremidade de VLAN compatível com esse ponto de extremidade de VLAN. Essa propriedade só é usada quando a propriedade DesiredVLANEndpointMode é definida como 1 (Outro). Essa propriedade deve ser definida como Null quando a propriedade DesiredVLANEndpointMode for qualquer valor diferente de 1. Essa propriedade é herdada de CIM_EthernetPortAllocationSettingData.

OtherResourceType

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Uma cadeia de caracteres que descreve o tipo de recurso quando um valor bem definido não está disponível e ResourceType é definido como 0 ("Outros"). Essa propriedade é herdada de CIM_ResourceAllocationSettingData e não é usada.

Pai

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

O pai do recurso. Por exemplo, um controlador para a alocação atual. Essa propriedade é herdada de CIM_ResourceAllocationSettingData.

PoolID

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

O pool do qual o recurso está alocado no momento ou o pool do qual o recurso será alocado quando a alocação ocorrer. Essa propriedade é herdada de CIM_ResourceAllocationSettingData.

Reserva

Tipo de dados: uint64

Tipo de acesso: Somente leitura

A quantidade de recurso garantida para estar disponível para essa alocação. Em sistemas que dão suporte ao excesso de compromisso de recursos, esse valor normalmente é usado para o controle de admissão para impedir que uma alocação seja aceita. Essa propriedade é herdada de CIM_ResourceAllocationSettingData e é sempre definida como 1.

ResourceSubType

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Uma cadeia de caracteres que descreve um subtipo específico de implementação para esse recurso. Por exemplo, isso pode ser usado para distinguir diferentes modelos do mesmo tipo de recurso. Essa propriedade é herdada de CIM_ResourceAllocationSettingData e é sempre definida como "Porta Ethernet Emulada da Microsoft".

ResourceType

Tipo de dados: uint16

Tipo de acesso: Somente leitura

O tipo de recurso ao qual essa configuração se aplica. Essa propriedade é herdada de CIM_ResourceAllocationSettingData e sempre é definida como 10 (Adaptador Ethernet).

StaticMacAddress

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Indica se um endereço MAC estático deve ser usado.

Essa é uma propriedade somente leitura, mas pode ser alterada usando o método ModifyResourceSettings da classe Msvm_VirtualSystemManagementService .

VirtualQuantity

Tipo de dados: uint64

Tipo de acesso: Somente leitura

A quantidade de recursos apresentados ao consumidor. Essa propriedade é herdada de CIM_ResourceAllocationSettingData e é sempre definida como 1.

VirtualQuantityUnits

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Especifica a unidade de medida para essa alocação de recursos. O valor dessa propriedade deve ser um valor legal do qualificador de Unidades Programáticas, conforme definido no Anexo C.1 de DSP0004 V2.5 ou posterior. Essa propriedade é herdada de CIM_ResourceAllocationSettingData.

Weight

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Uma prioridade relativa para essa alocação em relação a outras alocações do mesmo ResourcePool. Essa propriedade é herdada de CIM_ResourceAllocationSettingData e é sempre definida como 0.

Comentários

O acesso à classe Msvm_EmulatedEthernetPortSettingData 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_EthernetPortAllocationSettingData

CIM_ResourceAllocationSettingData