Msvm_GuestServiceInterfaceComponentSettingData 類別

發行項
10/11/2023

表示客體服務介面元件的已設定狀態。這個類別衍生自 CIM_ResourceAllocationSettingData 類別。

下列語法會從 MOF 程式碼簡化，並包含所有繼承的屬性。

語法

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_GuestServiceInterfaceComponentSettingData : CIM_ResourceAllocationSettingData
{
  string  ElementName;
  string  InstanceID;
  uint16  ResourceType;
  string  OtherResourceType;
  string  ResourceSubType;
  string  PoolID;
  uint16  ConsumerVisibility;
  string  HostResource[];
  string  AllocationUnits;
  uint64  VirtualQuantity;
  uint64  Reservation;
  uint64  Limit;
  uint32  Weight;
  boolean AutomaticAllocation;
  boolean AutomaticDeallocation;
  string  Parent;
  string  Connection[];
  string  Address;
  uint16  MappingBehavior;
  uint16  EnabledState = 3;
  uint16  DefaultEnabledStatePolicy = 2;
};

成員

Msvm_GuestServiceInterfaceComponentSettingData 類別具有下列類型的成員：

屬性

屬性

Msvm_GuestServiceInterfaceComponentSettingData 類別具有這些屬性。

地址

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

資源的位址。例如，乙太網路埠的 MAC 位址。

AllocationUnits

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

這個屬性會指定 Reservation 和 Limit 屬性所使用的配置單位。例如，當 ResourceType=Processor 時，AllocationUnits 可能會設定為 MHz。當 ResourceType=Memory 時，AllocationUnits 可能會設定為 MB

AutomaticAllocation

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

這個屬性會指定資源是否會自動設定。例如，當設定為 true 時，當取用的虛擬電腦系統開啟電源時，將會配置此資源。 false 值表示必須明確配置資源。例如，此設定可能代表卸載式媒體（也就是 cdrom 或 floppy），其中在電源時，媒體不存在。需要明確的作業才能配置資源。

AutomaticDeallocation

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

這個屬性會指定資源是否會自動解除配置。例如，當設定為 true 時，當取用的虛擬電腦系統關閉電源時，將會取消配置此資源。當設定為 false 時，資源會維持配置狀態，而且必須明確解除配置。

[連接]

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

此資源所連接的專案。例如，具名網路或交換器埠。

ConsumerVisibility

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

描述已配置資源的取用者可見度。

值	意義
Unknown 0	未知。
傳遞 2	基礎或主機資源會利用並傳遞至取用者，可能使用資料分割。 DeviceID 屬性中至少應該有一個專案。
虛擬 3	資源已虛擬化，且可能不會直接對應至基礎/主機資源。某些實作可能支援虛擬化資源的特定指派，在此情況下，主機資源會使用 DeviceID 屬性公開。
未表示 4	資源的表示不存在於資源取用者的內容中。
保留 DMTF ..
廠商保留 32767..65535

DefaultEnabledStatePolicy

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

根據預設，客體通訊服務的啟用和停用狀態。

這是唯讀屬性，但可以使用 Msvm_VirtualSystemManagementService 類別的 ModifyResource設定 方法加以變更。

注意

已在 Windows 10 中新增。

已啟用 （2）

已停用（3）

ElementName

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

SettingData 實例的顯示名稱。此外，顯示名稱也可以當做搜尋或查詢的索引屬性使用。（注意：名稱在命名空間內不一定是唯一的。

EnabledState

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

專案的啟用和停用狀態。

這是唯讀屬性，但可以使用 Msvm_VirtualSystemManagementService 類別的 ModifyVirtualSystemResources 方法（或 ModifyResource設定 ，在 Windows 10 或更新版本中變更此屬性。

有效值為：

已啟用 （2）

已停用（3）

HostResource

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

這個屬性會公開主機或基礎資源的特定指派。內嵌實例只能包含索引鍵屬性，並視為物件路徑。如果虛擬資源可能會排程在數個基礎資源上，此屬性應維持 Null 。在此情況下，DeviceAllocatedFromPool 或 ResourceAllocationFromPool 關聯可用來判斷此虛擬資源可排程所在的主機資源集區。如果使用特定指派，則此虛擬資源所使用的所有基礎資源都應該列在此陣列中。一般而言，陣列會包含一個專案，不過針對匯總配置，例如多個處理器，可能會指定多個主機資源。

InstanceID

資料類型：字串
存取類型：唯讀
限定詞： 索引鍵

在具現化命名空間的範圍內，InstanceID 不透明且唯一識別這個類別的實例。若要確保 NameSpace 內的唯一性，應該使用下列「慣用」演算法來建構 InstanceID 的值：OrgID： LocalID 其中 OrgID 和 LocalID 會以冒號分隔（:)， 以及 OrgID 必須包含著作權、商標或其他唯一名稱，而該名稱是由建立或定義 InstanceID 的商務實體所擁有，或是由可辨識的全域識別指派給商務實體的已註冊識別碼權威。（這項需求類似于 Schema 類別名稱的 SchemaName _ ClassName 結構。此外，為了確保唯一性， OrgID 不得包含冒號（:)。使用此演算法時，在 InstanceID 中顯示的第一個冒號必須出現在 OrgID 和 LocalID 之間 。 LocalID 是由商業實體選擇，不應重複使用來識別不同的基礎（真實世界）元素。如果未使用上述「慣用」演算法，定義實體必須確保產生的 InstanceID 不會跨這個或這個實例之 NameSpace 的其他提供者所產生的任何 InstanceID 重複使用。對於 DMTF 定義的實例，「慣用」演算法必須與設定為 CIM 的 OrgID 搭配使用。

限制

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

這個屬性會指定將授與此配置之資源上限或最大數量。例如，支援記憶體分頁的系統可能支援設定 VirtualQuantity 以下的記憶體配置限制，因此會強制針對此配置進行分頁。

MappingBehavior

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

指定此資源對應至基礎資源的方式。如果 HostResource 陣列包含任何專案，這個屬性會反映資源對應至這些特定資源的方式。

未知（0）
不支援 （1）
專用（2）
軟親和性 （3）
硬親和性 （4）
DMTF 保留 （..）
廠商保留 （32767..65535）

OtherResourceType

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

當定義良好的值無法使用且 ResourceType 具有值「Other」時，描述資源類型的字串。

上層

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

資源的父代。例如，目前配置的控制器。

PoolID

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

這個屬性會指定資源目前配置的來源 ResourcePool，或資源在配置發生時會從中配置的資源集區。

保留容量

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

這個屬性會指定保證可供此配置使用的資源數量。在支援過度承諾資源的系統上，此值通常用於許可控制，以防止接受配置，從而防止資源耗盡。

ResourceSubType

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

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

ResourceType

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

此配置設定所代表的資源類型。

其他（1）
電腦系統 （2）
處理器 （3）
記憶體 （4）
IDE 控制器 （5）
平行 SCSI HBA （6）
FC HBA （7）
iSCSI HBA （8）
IB HCA （9）
乙太網路卡 （10）
其他網路介面卡 （11）
I/O 插槽 （12）
I/O 裝置 （13）
軟碟磁碟機 （14）
CD 磁片磁碟機 （15）
DVD 光碟機 （16）
序列埠 （17）
平行埠 （18）
USB 控制器 （19）
圖形控制器 （20）
儲存體範圍 （21）
磁片（22）
磁帶（23）
其他存放裝置 （24）
Firewire 控制器 （25）
可分割單位 （26）
基底可分割單位 （27）
電源供應器 （28）
冷卻裝置 （29）
DMTF 保留 （..）
廠商保留 （32767..65535）

VirtualQuantity

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

這個屬性會指定提供給取用者的資源數量。例如，當 ResourceType=Processor 時，這個屬性會反映向虛擬電腦系統呈現的離散處理器數目。當 ResourceType=Memory 時，此屬性可能會反映向虛擬電腦系統回報的 MB 數目。

Weight

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

這個屬性會指定這個配置相對於相同 ResourcePool 的其他配置相對優先順序。此屬性沒有測量單位，而且只有在與其他配置競爭相同主機資源時才相關。

需求

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

另請參閱

CIM_ResourceAllocationSettingData
CIM_ResourceAllocationSettingData

共用方式為

Msvm_GuestServiceInterfaceComponentSettingData 類別

語法

成員

屬性

需求

另請參閱

意見反應

其他資源