Msvm_VirtualSystemManagementService 類別
表示存在於單一主機系統上的虛擬化服務。 Msvm_VirtualSystemManagementService 可用來控制虛擬機器的定義、修改和刪除。 它也具有在虛擬機器上執行作業的方法，例如複製、快照集，以及匯入或匯出虛擬機器。 若要擷取每個虛擬機器的資訊，請使用 Msvm_ComputerSystem。
下列語法是簡化 Managed 物件格式 (MOF) 程式碼，並包含所有繼承的屬性。
語法
[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_VirtualSystemManagementService : CIM_VirtualSystemManagementService
{
string InstanceID;
string Caption = "Virtual System Management Service";
string Description = "Service for creating, manipulating, and managing virtual machines";
string ElementName = "Hyper-V Virtual System Management Service";
datetime InstallDate;
string Name = "vmms";
uint16 OperationalStatus[] = { 2 };
string StatusDescriptions[] = { "The service is running normally" };
string Status;
uint16 HealthState = 5;
uint16 CommunicationStatus;
uint16 DetailedStatus;
uint16 OperatingStatus;
uint16 PrimaryStatus;
uint16 EnabledState = 2;
string OtherEnabledState;
uint16 RequestedState = 12;
uint16 EnabledDefault = 2;
datetime TimeOfLastStateChange;
uint16 AvailableRequestedStates[];
uint16 TransitioningToState;
string SystemCreationClassName = "Msvm_ComputerSystem";
string SystemName;
string CreationClassName = "Msvm_VirtualSystemManagementService";
string PrimaryOwnerName;
string PrimaryOwnerContact;
string StartMode;
boolean Started = True;
};
成員
Msvm_VirtualSystemManagementService類別具有下列類型的成員：
方法
Msvm_VirtualSystemManagementService類別具有這些方法。
| 方法 | 描述 |
|---|---|
| AddBootSourceSettings | 將開機來源套用至「狀態」虛擬系統組態時，將開機來源新增至虛擬系統組態。 |
| AddFeatureSettings | 將乙太網路功能設定新增至虛擬機器乙太網路連線的組態。 |
| AddFibreChannelChap | 將 DH-CHAP 參數新增至虛擬機器中的綜合光纖通道埠。 |
| AddGuestServiceSettings | 將客體服務設定新增至虛擬系統組態。 套用至「目前」虛擬系統組態的元件時，可能會修改作用中虛擬系統的副作用客體服務。 |
| AddKvpItems | 將機碼/值組新增至虛擬機器。 |
| AddResourceSettings | 將資源新增至虛擬機器組態。 |
| AddSystemComponentSettings | 將一般設定新增至虛擬系統組態。 |
| DefinePlannedSystem | 定義規劃的虛擬系統。 未完全指定的輸入可能會填入預設值。 |
| DefineSystem | 建立新的虛擬機器定義。 |
| DestroySystem | 刪除現有的虛擬機器定義。 |
| DiagnoseNetworkConnection | 診斷 Windows 網路虛擬化環境中的 VM 網路連線。 |
| ExportSystemDefinition | 將虛擬機器或虛擬機器的快照集匯出至檔案。 |
| FormatError | 針對指定的內嵌 Msvm_Error 實例陣列，傳回格式化的錯誤訊息字串。 |
| GenerateWwpn | (WWPN) 產生一組萬維埠名稱。 |
| GetCurrentWwpnFromGenerator | 提供預覽目前的全球通訊埠名稱 (WWPN) ，而不保留 WWPN 的功能。 |
| GetDefinitionFileSummaryInformation | 傳回指定之虛擬機器定義檔案的虛擬機器摘要資訊。 |
| GetSizeOfSystemFiles | 擷取虛擬機器系統檔案的總大小。 |
| GetSummaryInformation | 傳回虛擬機器摘要資訊。 |
| GetVirtualSystemThumbnailImage | 擷取現有虛擬機器的縮圖影像。 |
| ImportSnapshotDefinitions | 搜尋指定的資料夾，尋找與指定計劃的電腦系統相關聯的任何快照定義檔案，並在計畫的電腦系統上為此位置中的每個相關聯定義檔建立新的快照集。 |
| ImportSystemDefinition | 根據指定的虛擬機器定義，建立新的計劃性電腦系統。 |
| ModifyDiskMergeSettings | 修改磁片合併設定資料。 |
| ModifyFeatureSettings | 修改虛擬機器乙太網路連線的目前功能設定。 |
| ModifyGuestServiceSettings | 修改客體服務設定。 套用至「目前」虛擬系統組態的元件時，可能會修改作用中虛擬系統的副作用客體服務。 |
| ModifyKvpItems | 修改虛擬機器上現有的機碼/值組。 |
| ModifyResourceSettings | 修改虛擬資源設定。 |
| ModifyServiceSettings | 修改服務的設定資料。 |
| ModifySystemComponentSettings | 修改泛型系統元件設定。 |
| ModifySystemSettings | 修改虛擬機器設定。 |
| RealizePlannedSystem | 驗證計畫虛擬機器的設定，並將它轉換成已實現的虛擬機器。 |
| RemoveBootSourceSettings | 從虛擬系統組態中移除虛擬資源設定。 當套用至「目前」虛擬系統組態的元件時，可能會移除作用中虛擬系統的副作用資源。 |
| RemoveFeatureSettings | 從虛擬機器乙太網路連線中移除功能設定。 |
| RemoveFibreChannelChap | 從虛擬機器中的綜合光纖通道埠中移除 DH-CHAP 參數。 |
| RemoveGuestServiceSettings | 從虛擬系統組態中移除客體服務設定。 套用至「目前」虛擬系統組態的元件時，可能會修改作用中虛擬系統的副作用客體服務。 |
| RemoveKvpItems | 從虛擬機器中移除現有的機碼/值組。 |
| RemoveResourceSettings | 從虛擬機器組態中移除虛擬資源設定。 |
| RemoveSystemComponentSettings | 從虛擬系統組態中移除一般元件設定。 |
| RequestStateChange | 不支援這個方法。 |
| SetGuestNetworkAdapterConfiguration | 設定客體作業系統內的網路介面卡。 |
| SetInitialMachineConfigurationData | 設定 VM 的初始電腦設定資料。 |
| StartService | 不支援這個方法。 |
| StopService | 不支援這個方法。 |
| TestNetworkConnection | 在 Windows 網路虛擬化環境中測試 VM 的網路連線能力。 |
| UpgradeSystemVersion | 升級虛擬系統。 套用至「目前」虛擬系統組態的系統設定時 |
| ValidatePlannedSystem | 驗證指定的計畫系統。 |
屬性
Msvm_VirtualSystemManagementService類別具有這些屬性。
-
AvailableRequestedStates
-
-
資料類型： uint16 陣列
-
存取類型：唯讀
指出RequestStateChange方法之 RequestedState參數的可能值。 此屬性繼承自 CIM_EnabledLogicalElement，而且一律設定為 Null。
-
-
標題
-
-
資料類型： 字串
-
存取類型：唯讀
物件的簡短描述。 此屬性繼承自 CIM_ManagedElement，而且一律設定為 「Hyper-V Virtual System Management Service」。
-
-
CommunicationStatus
-
-
資料類型： uint16
-
存取類型：唯讀
指出檢測能夠與基礎 Managed 專案通訊。 Null值表示這個屬性未實作。 此屬性繼承自 CIM_ManagedSystemElement。
-
未知 (0)
-
無法使用 (1)
-
通訊正常 (2)
-
遺失通訊 (3)
-
沒有連絡人 (4)
-
DMTF 保留 (。。)
-
廠商保留 (0x8000。)
-
-
CreationClassName
-
-
資料類型： 字串
-
存取類型：唯讀
-
限定詞： Key、 MaxLen ( 256 )
建立實例時所使用的類別或子類別名稱。 此屬性繼承自 CIM_Service，而且一律設定為 「Msvm_VirtualSystemManagementService」。
-
-
說明
-
-
資料類型： 字串
-
存取類型：唯讀
對物件的描述。 此屬性繼承自 CIM_ManagedElement，而且一律設定為 「建立、操作和管理虛擬機器的服務」。
-
-
DetailedStatus
-
-
資料類型： uint16
-
存取類型：唯讀
使用其他狀態詳細資料來補充 PrimaryStatus 屬性。 Null值表示這個屬性未實作。 此屬性繼承自 CIM_ManagedSystemElement。
-
無法使用 (0)
-
沒有其他資訊 (1)
-
壓力 (2)
-
預測性失敗 (3)
-
無法復原的錯誤 (4)
-
錯誤 (5) 支援實體
-
DMTF 保留 (。。)
-
廠商保留 (0x8000。)
-
-
ElementName
-
-
資料類型： 字串
-
存取類型：唯讀
物件的顯示名稱。 此屬性繼承自 CIM_ManagedElement，而且一律設定為 「Hyper-V Virtual System Management Service」。
-
-
EnabledDefault
-
-
資料類型： uint16
-
存取類型：唯讀
系統管理員的元素啟用狀態的預設或啟動組態。 此屬性繼承自 CIM_EnabledLogicalElement，且一律設定為 2 (Enabled) 。
值 意義 - 2
啟用 -
-
EnabledState
-
-
資料類型： uint16
-
存取類型：唯讀
專案的啟用和停用狀態。 這個屬性也可以指出這些要求狀態之間的轉換。 此屬性繼承自 CIM_EnabledLogicalElement，且一律設定為 2 (Enabled) 。
值 意義 - 2
啟用 -
-
HealthState
-
-
資料類型： uint16
-
存取類型：唯讀
專案目前的健全狀況。 這個屬性工作表示這個專案的健康情況，但不一定表示其子元件的健全狀況。 可能的值為 0 到 30，其中 5 表示元素狀況完全良好，而 30 表示元素完全非功能。 此屬性繼承自 CIM_ManagedSystemElement，而且一律設定為 5 (OK) 。
值 意義 - 5
健康情況狀態正常。 -
-
InstallDate
-
-
資料類型： datetime
-
存取類型：唯讀
建立虛擬機器組態的日期和時間。 此屬性繼承自 CIM_ManagedSystemElement。
-
-
InstanceID
-
-
資料類型： 字串
-
存取類型：唯讀
-
限定詞： 金鑰
唯一識別這個類別的實例。 此屬性繼承自 CIM_ManagedElement。
-
-
名稱
-
-
資料類型： 字串
-
存取類型：唯讀
-
限定詞： Key、 MaxLen ( 256 )
已知物件的標籤。 此屬性繼承自 CIM_ManagedSystemElement，而且一律會設定為 「vmms」。
-
-
OperatingStatus
-
-
資料類型： uint16
-
存取類型：唯讀
提供元素作業條件的目前狀態資訊，並可用來提供 有關 EnabledState 屬性值的詳細資料。 Null值表示這個屬性未實作。 此屬性繼承自 CIM_ManagedSystemElement。
-
未知 (0)
-
無法使用 (1)
-
服務 (2)
-
從 (3 開始)
-
停止 (4)
-
已停止 (5)
-
中止 (6)
-
休眠 (7)
-
已完成 (8)
-
移 轉 (9)
-
Emigrating (10)
-
( 11)
-
快照 集 (12)
-
關閉 (13)
-
在測試 (14)
-
轉換 (15)
-
在 Service (16)
-
DMTF 保留 (。。)
-
廠商保留 (0x8000。)
-
-
OperationalStatus
-
-
資料類型： uint16 陣列
-
存取類型：唯讀
物件的目前狀態。 此屬性繼承自 CIM_ManagedSystemElement，而且每個陣列元素一律會設定為 2 (OK) 。
-
-
OtherEnabledState
-
-
資料類型： 字串
-
存取類型：唯讀
字串，描述 EnabledState 屬性設定為 1 (「Other」) 時，元素的啟用或停用狀態。 當EnabledState是 1 以外的任何值時，此屬性必須設定為Null。 此屬性繼承自 CIM_EnabledLogicalElement，而且一律會設定為 Null。
-
-
PrimaryOwnerContact
-
-
資料類型： 字串
-
存取類型：唯讀
-
限定詞： MaxLen ( 256 )
關於服務主要擁有者如何 (連線的任何資訊，例如電話號碼、電子郵件地址等等) 。 此屬性繼承自 CIM_Service，而且一律會設定為 Null。
-
-
PrimaryOwnerName
-
-
資料類型： 字串
-
存取類型：唯讀
-
限定詞： MaxLen ( 64 )
如果已定義服務，則為服務的主要擁有者名稱。 主要擁有者是服務的初始支援連絡人。 此屬性繼承自 CIM_Service，而且一律會設定為 Null。
-
-
PrimaryStatus
-
-
資料類型： uint16
-
存取類型：唯讀
提供高階狀態資訊。 此屬性應該與 DetailedStatus 屬性搭配使用，以提供元素及其子元件的高階和詳細健全狀態。 Null值表示這個屬性未實作。 此屬性繼承自 CIM_ManagedSystemElement。
-
未知 (0)
-
確定 (1)
-
降級 (2)
-
錯誤 (3)
-
DMTF 保留 (。。)
-
廠商保留 (0x8000。)
-
-
RequestedState
-
-
資料類型： uint16
-
存取類型：唯讀
專案的最後一個要求或所需狀態。 專案的實際狀態是由 EnabledState表示。 提供這個屬性來比較元素的最後一個要求和目前狀態。 CIM_EnabledLogicalElement類別的特定實例可能不支援RequestedState屬性。 如果發生這種情況，則會使用值 12 (「不適用」) 。 此屬性繼承自 CIM_EnabledLogicalElement，而且一律會設定為 12 (不適用) 。
值 意義 - 12
不適用。 -
-
Started
-
-
資料類型： 布林值
-
存取類型：唯讀
指出服務目前是否正在執行。 此屬性繼承自 CIM_Service，而且一律會設定為 True。
-
-
StartMode
-
-
資料類型： 字串
-
存取類型：唯讀
-
限定詞： MaxLen ( 10 )
字串值，指出服務是否由系統、作業系統自動啟動，或只在要求時啟動。 此屬性繼承自 CIM_Service，而且一律會設定為 Null。
-
-
狀態
-
-
資料類型： 字串
-
存取類型：唯讀
此屬性繼承自 CIM_ManagedSystemElement，但不會使用。
-
-
StatusDescriptions
-
-
資料類型： 字串 陣列
-
存取類型：唯讀
描述各種 OperationalStatus 陣列值的字串。 此屬性繼承自 CIM_ManagedSystemElement，而且每個陣列元素一律會設定為「服務正常執行」。
-
-
SystemCreationClassName
-
-
資料類型： 字串
-
存取類型：唯讀
-
限定詞： Key、 MaxLen ( 256 )
界定系統的建立類別名稱。 此屬性繼承自 CIM_Service，而且一律會設定為 「Msvm_ComputerSystem」。
-
-
SystemName
-
-
資料類型： 字串
-
存取類型：唯讀
-
限定詞： Key、 MaxLen ( 256 )
主控電腦系統的 NetBIOS 名稱。 此屬性繼承自 CIM_Service。
-
-
TimeOfLastStateChange
-
-
資料類型： datetime
-
存取類型：唯讀
上次變更專案啟用狀態的日期或時間。 此屬性繼承自 CIM_EnabledLogicalElement。
-
-
TransitioningToState
-
-
資料類型： uint16
-
存取類型：唯讀
指出實例正在轉換的目標狀態。 此屬性繼承自 CIM_EnabledLogicalElement，而且一律會設定為 Null。
-
備註
Msvm_VirtualSystemManagementService 類別的 存取可能會受到 UAC 篩選的限制。 如需詳細資訊，請參閱 使用者帳戶控制和 WMI。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows 8 [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows Server 2012 [僅限傳統型應用程式] |
| 命名空間 |
Root\Virtualization\V2 |
| MOF |
|
| DLL |
|