Поделиться через

Класс Msvm_SyntheticEthernetPortSettingData

  • Статья

Представляет настроенное состояние искусственного адаптера Ethernet.

Следующий синтаксис представляет собой упрощенный код формата управляемого объекта (MOF) и включает все унаследованные свойства.

Синтаксис

[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;
};

Члены

Класс Msvm_SyntheticEthernetPortSettingData имеет следующие типы членов:

Элемент Property

Класс Msvm_SyntheticEthernetPortSettingData имеет следующие свойства.

Адрес

Тип данных: string

Тип доступа: только для чтения

Адрес ресурса. Например, MAC-адрес порта Ethernet. Это свойство наследуется от CIM_ResourceAllocationSettingData.

AddressOnParent

Тип данных: string

Тип доступа: только для чтения

Описывает адрес этого ресурса в контексте родительского ресурса. Свойства Parent и AddressOnParent используются для описания связи контроллера, а также порядка устройств на контроллере. Это свойство наследуется от CIM_ResourceAllocationSettingData.

AllocationUnits

Тип данных: string

Тип доступа: только для чтения

Единицы распределения, используемые свойствами Reservation и Limit . Это свойство наследуется от CIM_ResourceAllocationSettingData.

AllowPacketDirect

Тип данных: boolean

Тип доступа: чтение и запись

Указывает, включена ли проекция PacketDirect для виртуальной машины.

Примечание

Добавлено в Windows 10 версии 1703 и Windows Server 2016.

Автоматическое размещение

Тип данных: boolean

Тип доступа: только для чтения

Указывает, будет ли ресурс выделен автоматически. Это свойство наследуется от CIM_ResourceAllocationSettingData.

Автоматическое определение доступности

Тип данных: boolean

Тип доступа: только для чтения

Указывает, будет ли ресурс автоматически освобожден. Это свойство наследуется от CIM_ResourceAllocationSettingData.

Caption

Тип данных: string

Тип доступа: только для чтения

Краткое описание объекта. Это свойство наследуется от CIM_ManagedElement.

ClusterMonitored

Тип данных: boolean

Тип доступа: только для чтения

Указывает, отслеживается ли этот адаптер Ethernet кластером. Это свойство по умолчанию имеет значение true, если оно не настроено.

Это свойство доступно только для чтения, но его можно изменить с помощью метода ModifyResourceSettings класса Msvm_VirtualSystemManagementService .

Windows 8.1: это значение не поддерживается до Windows 8.1 и Windows Server 2012 R2.

Соединение

Тип данных: строковый массив

Тип доступа: только для чтения

Объект, к которому подключен этот ресурс. Например, именованный сетевой порт или порт коммутатора. Это свойство наследуется от CIM_ResourceAllocationSettingData.

ConsumerVisibility

Тип данных: uint16

Тип доступа: только для чтения

Видимость потребителей выделенного ресурса. Это свойство наследуется от CIM_ResourceAllocationSettingData и всегда имеет значение 3 (виртуализированный).

Описание

Тип данных: string

Тип доступа: только для чтения

Описание объекта. Это свойство наследуется от CIM_ManagedElement.

DesiredVLANEndpointMode

Тип данных: uint16

Тип доступа: только для чтения

Требуемый режим конфигурации для конечной точки виртуальной локальной сети. Это свойство используется для задания начального значения свойства OperationalEndpointMode в экземпляре класса Msvm_VLANEndpoint , связанном с целевым портом Ethernet. Возможные значения см. в разделе Свойство OperationalEndpointMode класса Msvm_VLANEndpoint . Это свойство наследуется от CIM_EthernetPortAllocationSettingData.

DeviceNamingEnabled

Тип данных: boolean

Тип доступа: только для чтения

Указывает, поддерживает ли этот адаптер Ethernet именование устройств.

Это свойство доступно только для чтения, но его можно изменить с помощью метода ModifyVirtualSystemResources класса Msvm_VirtualSystemManagementService .

Примечание

Добавлено в Windows 10 и Windows Server 2016.

ElementName

Тип данных: string

Тип доступа: только для чтения

Краткое описание объекта. Это свойство наследуется от CIM_SettingData.

HostResource

Тип данных: строковый массив

Тип доступа: только для чтения

Это свойство наследуется от CIM_ResourceAllocationSettingData и всегда имеет значение Null.

InstanceID

Тип данных: string

Тип доступа: только для чтения

Квалификаторы: Ключ

Уникально идентифицирует экземпляр этого класса. Это свойство наследуется от CIM_ManagedElement.

Ограничение

Тип данных: uint64

Тип доступа: только для чтения

Верхняя граница или максимальный объем ресурса, который будет предоставлен для этого выделения. Это свойство наследуется от CIM_ResourceAllocationSettingData.

MappingBehavior

Тип данных: uint16

Тип доступа: только для чтения

Указывает, как этот ресурс сопоставляется с базовыми ресурсами. Это свойство наследуется от CIM_ResourceAllocationSettingData.

OtherEndpointMode

Тип данных: string

Тип доступа: только для чтения

Строка, описывающая тип модели конечной точки виртуальной ЛС, поддерживаемой этой конечной точкой виртуальной локальной сети. Это свойство используется только в том случае, если свойству DesiredVLANEndpointMode присвоено значение 1 (Другое). Это свойство должно иметь значение Null , если свойство DesiredVLANEndpointMode имеет любое значение, отличное от 1. Это свойство наследуется от CIM_EthernetPortAllocationSettingData.

OtherResourceType

Тип данных: string

Тип доступа: только для чтения

Строка, описывающая тип ресурса, если четко определенное значение недоступно, а resourceType имеет значение Other (0). Это свойство наследуется от CIM_ResourceAllocationSettingData и не используется.

Parent

Тип данных: string

Тип доступа: только для чтения

Родительский объект ресурса. Например, контроллер для текущего выделения. Это свойство наследуется от CIM_ResourceAllocationSettingData.

PoolID

Тип данных: string

Тип доступа: только для чтения

Пул, из которого в данный момент выделен ресурс, или пул, из которого будет выделен ресурс при выделении. Это свойство наследуется от CIM_ResourceAllocationSettingData.

Резервирование

Тип данных: uint64

Тип доступа: только для чтения

Объем ресурса, гарантированно доступный для этого выделения. В системах, поддерживающих чрезмерную приверженность ресурсам, это значение обычно используется для контроля допуска, чтобы предотвратить принятие выделения ресурсов. Это свойство наследуется от CIM_ResourceAllocationSettingData.

ResourceSubType

Тип данных: string

Тип доступа: только для чтения

Строка, описывающая конкретный подтип реализации для этого ресурса. Например, это можно использовать для различения разных моделей одного и того же типа ресурсов. Это свойство наследуется от CIM_ResourceAllocationSettingData.

ResourceType

Тип данных: uint16

Тип доступа: только для чтения

Тип ресурса, к которому применяется этот параметр. Это свойство наследуется от CIM_ResourceAllocationSettingData и всегда имеет значение 10 (Адаптер Ethernet).

StaticMacAddress

Тип данных: boolean

Тип доступа: только для чтения

Указывает, является ли MAC-адрес статическим.

VirtualQuantity

Тип данных: uint64

Тип доступа: только для чтения

Количество ресурсов, представленных потребителю. Это свойство наследуется от CIM_ResourceAllocationSettingData.

VirtualQuantityUnits

Тип данных: string

Тип доступа: только для чтения

Задает единицу измерения для свойства VirtualQuantity . Значение этого свойства должно быть юридическим значением квалификатора "Программные единицы", как определено в приложении C.1 DSP0004 версии 2.5 или более поздней версии. Это свойство наследуется от CIM_ResourceAllocationSettingData.

VirtualSystemIdentifiers

Тип данных: строковый массив

Тип доступа: только для чтения

Квалификаторы: ArrayType ("Indexed")

Массив строк идентификаторов этого ресурса, представленный операционной системе виртуальной машины. Индексы и значения для каждого индекса определяются для каждого ресурса (то есть для каждого перечисленного значения свойства ResourceType ).

Weight

Тип данных: uint32

Тип доступа: только для чтения

Относительный приоритет для этого выделения по отношению к другим выделениям из того же пула ресурсов. Это свойство наследуется от CIM_ResourceAllocationSettingData.

Комментарии

Доступ к классу Msvm_SyntheticEthernetPortSettingData может быть ограничен фильтрацией UAC. Дополнительные сведения см. в разделе Контроль учетных записей пользователей и WMI.

Примеры

См. статью Запросы к сетевым объектам.

Требования

Требование Значение
Минимальная версия клиента
 Windows 8 [только классические приложения]
Минимальная версия сервера
 Windows Server 2012 [только классические приложения]
Пространство имен
 Root\Virtualization\V2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

См. также раздел

CIM_EthernetPortAllocationSettingData

CIM_ResourceAllocationSettingData