Msvm_VirtualSystemManagementService 類別的 RealizePlannedSystem 方法

驗證已規劃虛擬機器的組態，並將其轉換為已實現的虛擬機器。 如果適用，任何與虛擬機器相關聯的執行時間或儲存狀態檔案，都會從匯入目錄複寫到虛擬機器的資料根目錄。

語法

uint32 RealizePlannedSystem(
  [in]  Msvm_PlannedComputerSystem REF PlannedSystem,
  [out] CIM_ComputerSystem         REF ResultingSystem,
  [out] CIM_ConcreteJob            REF Job
);

參數

PlannedSystem [in]

要轉換成已實現虛擬機器 之Msvm_PlannedComputerSystem 實例的參考。

ResultingSystem [out]

如果作業同步完成，則表示所產生之已實現虛擬機器 之CIM_ComputerSystem 物件的參考。

從 Windows 10 1703 版Msvm_ComputerSystem更新的資料類型。

作業 [out]

如果以非同步方式執行作業，這個方法會傳回 4096，而且此參數會包含衍生自 CIM_ConcreteJob的物件參考。

傳回值

這個方法會傳回下列其中一個值。

已完成 ， (0)

已檢查方法參數 - 作業啟動 (4096)

失敗 (32768)

拒絕存取 (32769)

不支援 (32770)

狀態未知 (32771)

逾 時 (32772)

不正確參數 (32773)

系統正在使用 (32774)

此作業的狀態無效 ， (32775)

不正確的資料類型 (32776)

系統無法使用 (32777)

記憶體不足 (32778)

範例

下列 C# 範例會使用 RealizePlannedSystem 方法來實現規劃的虛擬機器。 此程式碼取自 Hyper-V 規劃的虛擬機器範例。 您可以在 虛擬範例的通用公用程式中找到參考的公用程式， (V2) 。

重要

若要正確運作，必須在虛擬機器主機伺服器上執行下列程式碼，而且必須使用系統管理員許可權執行。

/// <summary>
/// Finds the first Planned VM matching pvmName and realizes it.
/// </summary>
/// <param name="pvmName">The name of the PVM to be realized.</param>
/// <returns>The Realized Virtual Machine.</returns>
internal static ManagementObject
RealizePvm(
    string pvmName
    )
{
    ManagementObject vm = null;
    ManagementScope scope = new ManagementScope(@"root\virtualization\v2");

    using (ManagementObject pvm = WmiUtilities.GetPlannedVirtualMachine(pvmName, scope))
    using (ManagementObject managementService = WmiUtilities.GetVirtualMachineManagementService(scope))
    using (ManagementBaseObject inParams =
        managementService.GetMethodParameters("RealizePlannedSystem"))
    {
        inParams["PlannedSystem"] = pvm.Path;

        Console.WriteLine("Realizing Planned Virtual Machine \"{0}\" ({1})...",
                pvm["ElementName"], pvm["Name"]);

        using (ManagementBaseObject outParams =
            managementService.InvokeMethod("RealizePlannedSystem", inParams, null))
        {
            if (WmiUtilities.ValidateOutput(outParams, scope, true, true))
            {
                using (ManagementObject job =
                    new ManagementObject((string)outParams["Job"]))
                using (ManagementObjectCollection pvmCollection =
                    job.GetRelated("Msvm_ComputerSystem",
                        "Msvm_AffectedJobElement", null, null, null, null, false, null))
                {
                    vm = WmiUtilities.GetFirstObjectFromCollection(pvmCollection);
                }
            }
        }
    }

    return vm;
}

規格需求

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

另請參閱

Msvm_VirtualSystemManagementService