Msvm_VirtualSystemManagementService类的 ValidatePlannedSystem 方法

验证指定的计划系统。 这包括检查虚拟机配置、设备、快照配置、快照设备、保存的状态文件和存储文件。

语法

uint32 ValidatePlannedSystem(
  [in]  Msvm_PlannedComputerSystem REF PlannedSystem,
  [out] CIM_ConcreteJob            REF Job
);

参数

PlanningSystem [in]

对表示要验证的计划系统的 Msvm_PlannedComputerSystem 对象的引用。

作业 [out]

如果异步执行该操作,此方法将返回 4096,此参数将包含对派生自 CIM_ConcreteJob的对象的引用。

返回值

此方法返回以下值之一。

已完成且无错误 (0)

检查方法参数 - 作业启动 (4096)

失败 (32768)

访问被拒绝 (32769)

不支持 (32770)

状态未知 (32771)

超时 (32772)

参数 无效 (32773)

系统正在使用 (32774)

此操作的状态无效 , (32775)

数据类型不正确 , (32776)

系统不可用 (32777)

内存不足 (32778)

使用中的文件 (32779)

示例

以下 C# 示例使用 ValidatePlannedSystem 方法验证计划的虚拟机。 此代码取自 Hyper-V 计划的虚拟机示例。 可在通用实用工具中找到引用的 实用工具,以便 (V2) 的虚拟化示例

重要

若要正常运行,必须在虚拟机主机服务器上运行以下代码,并且必须使用管理员权限运行。

/// <summary>
/// Finds the first Planned VM matching pvmName and validates it, displaying
/// any warnings produced.
/// </summary>
/// <param name="pvmName">The name of the PVM to be validated.</param>
internal static void
ValidatePvm(
    string pvmName
    )
{
    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("ValidatePlannedSystem"))
    {
        inParams["PlannedSystem"] = pvm.Path;

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

        using (ManagementBaseObject outParams = 
            managementService.InvokeMethod("ValidatePlannedSystem", inParams, null))
        {
            if (WmiUtilities.ValidateOutput(outParams, scope))
            {
                using (ManagementObject job = 
                    new ManagementObject((string)outParams["Job"]))
                {
                    WmiUtilities.PrintMsvmErrors(job);
                }
            }
        }
    }
}

要求

要求
最低受支持的客户端
Windows 8 [仅限桌面应用]
最低受支持的服务器
Windows Server 2012 [仅限桌面应用]
命名空间
Root\Virtualization\V2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

另请参阅

Msvm_VirtualSystemManagementService