Msvm_SyntheticEthernetPortSettingData 類別

  • 發行項

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

下列語法是簡化 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