Método ValidatePlannedSystem de la clase Msvm_VirtualSystemManagementService

Artículo
06/12/2023

Valida el sistema planeado especificado. Esto implica comprobaciones de la configuración de la máquina virtual, los dispositivos, la configuración de instantáneas, los dispositivos de instantáneas, los archivos de estado guardados y los archivos de almacenamiento.

Sintaxis

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

Parámetros

PlannedSystem [in]: Referencia a un objeto Msvm_PlannedComputerSystem que representa el sistema planeado que se va a validar.
Trabajo [out]: Si la operación se realiza de forma asincrónica, este método devolverá 4096 y este parámetro contendrá una referencia a un objeto derivado de CIM_ConcreteJob.

Valor devuelto

Este método devuelve uno de los valores siguientes.

Completado sin error (0)
Parámetros del método activados: trabajo iniciado (4096)
Error (32768)
Acceso denegado (32769)
No compatible (32770)
El estado es desconocido (32771)
Tiempo de espera (32772)
Parámetro no válido (32773)
El sistema está en uso (32774)
Estado no válido para esta operación (32775)
Tipo de datos incorrecto (32776)
El sistema no está disponible (32777)
Memoria insuficiente (32778)
Archivo en uso (32779)

Ejemplos

En el ejemplo de C# siguiente se usa el método ValidatePlannedSystem para validar una máquina virtual planeada. Este código se toma del ejemplo de máquinas virtuales planeadas de Hyper-V. Las utilidades a las que se hace referencia se pueden encontrar en Utilidades comunes para los ejemplos de virtualización (V2).

Importante

Para funcionar correctamente, el código siguiente debe ejecutarse en el servidor host de la máquina virtual y debe ejecutarse con privilegios de administrador.

/// <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);
                }
            }
        }
    }
}

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 [solo aplicaciones de escritorio]
Espacio de nombres	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
Archivo DLL	Vmms.exe

Consulte también

Msvm_VirtualSystemManagementService