Compartilhar via

Classe Msvm_SyntheticEthernetPortSettingData

  • Artigo

Representa o estado configurado de um adaptador Ethernet sintético.

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_SyntheticEthernetPortSettingData : CIM_EthernetPortAllocationSettingData
{
  string  InstanceID;
  string  Caption = "Virtual Ethernet Port Default Settings";
  string  Description = "Describes the default settings for the virtual Ethernet port resources.";
  string  ElementName;
  uint16  ResourceType = 10;
  string  OtherResourceType;
  string  ResourceSubType = "Microsoft:Hyper-V:Synthetic Ethernet Port";
  string  PoolID;
  uint16  ConsumerVisibility = 3;
  string  HostResource[];
  string  AllocationUnits = "count";
  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;
  string  VirtualSystemIdentifiers[];
  boolean DeviceNamingEnabled = FALSE;
  boolean AllowPacketDirect = FALSE;
  boolean StaticMacAddress = False;
  boolean ClusterMonitored = TRUE;
};

Membros

A classe Msvm_SyntheticEthernetPortSettingData tem estes tipos de membros:

Propriedades

A classe Msvm_SyntheticEthernetPortSettingData 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.

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 Reservation e Limit . Essa propriedade é herdada de CIM_ResourceAllocationSettingData.

AllowPacketDirect

Tipo de dados: booliano

Tipo de acesso: leitura/gravação

Indica se a projeção PacketDirect está habilitada para a VM.

Observação

Adicionado em Windows 10, versão 1703 e Windows Server 2016.

AutomaticAllocation

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Indica se o recurso será alocado automaticamente. Essa propriedade é herdada de CIM_ResourceAllocationSettingData.

AutomaticDeallocation

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Indica se o recurso será desalocado automaticamente. Essa propriedade é herdada de CIM_ResourceAllocationSettingData.

Legenda

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Uma breve descrição do objeto. Essa propriedade é herdada de CIM_ManagedElement.

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.

ConsumerVisibility

Tipo de dados: uint16

Tipo de acesso: Somente leitura

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.

DesiredVLANEndpointMode

Tipo de dados: uint16

Tipo de acesso: Somente leitura

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

DeviceNamingEnabled

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Indica se esse adaptador ethernet dá suporte à nomenclatura de dispositivo.

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

Observação

Adicionado em Windows 10 e Windows Server 2016.

ElementName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Uma breve descrição do objeto. Essa propriedade é herdada de CIM_SettingData.

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

Qualificadores: Chave

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

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.

MappingBehavior

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Especifica como esse recurso é mapeado para recursos subjacentes. Essa propriedade é herdada de CIM_ResourceAllocationSettingData.

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 "Outro" (0). 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 de qual pool 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.

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.

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

Especifica se o endereço MAC é estático.

VirtualQuantity

Tipo de dados: uint64

Tipo de acesso: Somente leitura

A quantidade de recursos apresentados ao consumidor. Essa propriedade é herdada de CIM_ResourceAllocationSettingData.

VirtualQuantityUnits

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Especifica a unidade de medida para a propriedade VirtualQuantity . 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.

VirtualSystemIdentifiers

Tipo de dados: matriz de cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: ArrayType ("Indexado")

Uma matriz de cadeia de caracteres de identificadores desse recurso apresentada ao sistema operacional da máquina virtual. Os índices e valores por índice são definidos por recurso (ou seja, para cada valor de propriedade ResourceType enumerado).

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 pool de recursos. Essa propriedade é herdada de CIM_ResourceAllocationSettingData.

Comentários

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