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

資料類型: 字串

存取類型:唯讀

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

AllocationUnits

資料類型: 字串

存取類型:唯讀

ReservationLimit屬性所使用的配置單位。 此屬性繼承自 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

備註

UAC 篩選可能會限制 對 Msvm_SyntheticEthernetPortSettingData 類別的存取。 如需詳細資訊,請參閱 使用者帳戶控制和 WMI

範例

請參閱 查詢網路物件

規格需求

需求
最低支援的用戶端
Windows 8 [僅限傳統型應用程式]
最低支援的伺服器
Windows Server 2012 [僅限傳統型應用程式]
命名空間
Root\Virtualization\V2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

另請參閱

CIM_EthernetPortAllocationSettingData

CIM_ResourceAllocationSettingData