Método ValidatePlannedSystem de la clase Msvm_VirtualSystemManagementService
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 |
|
| Archivo DLL |
|