Msvm_VirtualSystemManagementService 类的 ValidatePlannedSystem 方法

  • 项目

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

语法

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

参数

PlannedSystem [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