Msvm_SyntheticEthernetPortSettingData 類別

發行項
06/13/2023

表示綜合乙太網路卡的設定狀態。

下列語法是簡化 Managed Object Format (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類別具有下列類型的成員：

屬性

屬性

Msvm_SyntheticEthernetPortSettingData類別具有這些屬性。

位址

資料類型：字串
存取類型：唯讀

資源的位址。例如，乙太網路埠的 MAC 位址。此屬性繼承自 CIM_ResourceAllocationSettingData。

AddressOnParent

資料類型：字串
存取類型：唯讀

描述父系內容中此資源的位址。 Parent和AddressOnParent屬性可用來描述控制器關聯性，以及控制器上的裝置順序。此屬性繼承自 CIM_ResourceAllocationSettingData。

AllocationUnits

資料類型：字串
存取類型：唯讀

Reservation和Limit屬性所使用的配置單位。此屬性繼承自 CIM_ResourceAllocationSettingData。

AllowPacketDirect

資料類型： 布林值
存取類型：讀取/寫入

指出 VM 是否已啟用 PacketDirect 投影。

注意

已在 Windows 10 版本 1703 和 Windows Server 2016中新增。

AutomaticAllocation

資料類型： 布林值
存取類型：唯讀

指出是否會自動設定資源。此屬性繼承自 CIM_ResourceAllocationSettingData。

AutomaticDeallocation

資料類型： 布林值
存取類型：唯讀

指出資源是否會自動解除配置。此屬性繼承自 CIM_ResourceAllocationSettingData。

標題

資料類型：字串
存取類型：唯讀

物件的簡短描述。此屬性繼承自 CIM_ManagedElement。

ClusterMonitored

資料類型： 布林值
存取類型：唯讀

指出叢集是否監視此乙太網路卡。如果未設定，此屬性預設為 true。

這是唯讀屬性，但可以使用Msvm_VirtualSystemManagementService類別的ModifyResourceSettings方法進行變更。

Windows 8.1：在 Windows 8.1 和 Windows Server 2012 R2 之前，不支援此值。

[連接]

資料類型：字串陣列
存取類型：唯讀

此資源所連接的事項。例如，具名網路或交換器埠。此屬性繼承自 CIM_ResourceAllocationSettingData。

ConsumerVisibility

資料類型： uint16
存取類型：唯讀

取用者對已配置資源的可見度。此屬性繼承自 CIM_ResourceAllocationSettingData，且一律會設定為 3 (虛擬化) 。

說明

資料類型：字串
存取類型：唯讀

對物件的描述。此屬性繼承自 CIM_ManagedElement。

DesiredVLANEndpointMode

資料類型： uint16
存取類型：唯讀

VLAN 端點所需的組態模式。這個屬性是用來在與目標乙太網路埠相關聯的Msvm_VLANEndpoint類別實例中設定初始OperationalEndpointMode屬性值。如需可能的值，請參閱Msvm_VLANEndpoint類別的OperationalEndpointMode屬性。此屬性繼承自 CIM_EthernetPortAllocationSettingData。

DeviceNamingEnabled

資料類型： 布林值
存取類型：唯讀

指出這個乙太網路卡是否支援裝置命名。

這是唯讀屬性，但可以使用Msvm_VirtualSystemManagementService類別的ModifyVirtualSystemResources方法來變更。

注意

已新增至 Windows 10 和 Windows Server 2016。

ElementName

資料類型：字串
存取類型：唯讀

物件的簡短描述。此屬性繼承自 CIM_SettingData。

HostResource

資料類型：字串陣列
存取類型：唯讀

此屬性繼承自 CIM_ResourceAllocationSettingData，而且一律會設定為 Null。

InstanceID

資料類型：字串
存取類型：唯讀
限定詞：金鑰

唯一識別這個類別的實例。此屬性繼承自 CIM_ManagedElement。

限制

資料類型： uint64
存取類型：唯讀

將授與此配置的資源上限或最大數量。此屬性繼承自 CIM_ResourceAllocationSettingData。

MappingBehavior

資料類型： uint16
存取類型：唯讀

指定此資源如何對應至基礎資源。此屬性繼承自 CIM_ResourceAllocationSettingData。

OtherEndpointMode

資料類型：字串
存取類型：唯讀

字串，描述此 VLAN 端點所支援的 VLAN 端點模型類型。只有當 DesiredVLANEndpointMode 屬性設定為 1 (Other) 時，才會使用這個屬性。當DesiredVLANEndpointMode屬性是 1 以外的任何值時，這個屬性應該設定為Null。此屬性繼承自 CIM_EthernetPortAllocationSettingData。

OtherResourceType

資料類型：字串
存取類型：唯讀

字串，描述定義完善的值無法使用時的資源類型， 且 ResourceType 設定為「Other」 (0) 。此屬性繼承自 CIM_ResourceAllocationSettingData，且不會使用。

父系

資料類型：字串
存取類型：唯讀

資源的父代。例如，目前配置的控制器。此屬性繼承自 CIM_ResourceAllocationSettingData。

PoolID

資料類型：字串
存取類型：唯讀

資源目前配置的集區，或資源將在配置發生時從中配置的資源集區。此屬性繼承自 CIM_ResourceAllocationSettingData。

保留容量

資料類型： uint64
存取類型：唯讀

保證可供此配置使用的資源數量。在支援過度承諾資源的系統上，此值通常用於許可控制，以防止接受配置。此屬性繼承自 CIM_ResourceAllocationSettingData。

ResourceSubType

資料類型：字串
存取類型：唯讀

字串，描述此資源的實作特定子類型。例如，這可用來區分相同資源類型的不同模型。此屬性繼承自 CIM_ResourceAllocationSettingData。

ResourceType

資料類型： uint16
存取類型：唯讀

此設定適用的資源類型。此屬性繼承自 CIM_ResourceAllocationSettingData，而且一律會設定為 10 (乙太網路卡) 。

StaticMacAddress

資料類型： 布林值
存取類型：唯讀

指定 MAC 位址是否為靜態。

VirtualQuantity

資料類型： uint64
存取類型：唯讀

提供給取用者的資源數量。此屬性繼承自 CIM_ResourceAllocationSettingData。

VirtualQuantityUnits

資料類型：字串
存取類型：唯讀

指定 VirtualQuantity 屬性的度量單位。此屬性的值必須是 DSP0004 V2.5 或更新版本附錄 C.1 中所定義的程式設計單位限定詞合法值。此屬性繼承自 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

共用方式為

Msvm_SyntheticEthernetPortSettingData 類別

語法

成員

屬性

備註

範例

規格需求

另請參閱

意見反應

其他資源