Metodo ValidatePlannedSystem della classe Msvm_VirtualSystemManagementService

Articolo
28/01/2024

Convalida il sistema pianificato specificato. Ciò comporta controlli della configurazione della macchina virtuale, dei dispositivi, della configurazione dello snapshot, dei dispositivi snapshot, dei file di stato salvati e dei file di archiviazione.

Sintassi

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

Parametri

PlannedSystem [in]: Riferimento a un oggetto Msvm_PlannedComputerSystem che rappresenta il sistema pianificato da convalidare.
Processo [out]: Se l'operazione viene eseguita in modo asincrono, questo metodo restituirà 4096 e questo parametro conterrà un riferimento a un oggetto derivato da CIM_ConcreteJob.

Valore restituito

Questo metodo restituisce uno dei valori seguenti.

Completato senza errore (0)
Parametri del metodo controllati - Processo avviato (4096)
Errore (32768)
Accesso negato (32769)
Non supportato (32770)
Lo stato è sconosciuto (32771)
Timeout (32772)
Parametro non valido (32773)
Il sistema è in uso (32774)
Stato non valido per questa operazione (32775)
Tipo di dati non corretto (32776)
Il sistema non è disponibile (32777)
Memoria insufficiente (32778)
File in uso (32779)

Esempio

L'esempio C# seguente usa il metodo ValidatePlannedSystem per convalidare una macchina virtuale pianificata. Questo codice viene tratto dall'esempio di macchine virtuali pianificate hyper-V. Le utilità a cui si fa riferimento sono disponibili nelle utilità comuni per gli esempi di virtualizzazione (V2).

Importante

Per funzionare correttamente, il codice seguente deve essere eseguito nel server host della macchina virtuale e deve essere eseguito con privilegi di amministratore.

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Spazio dei nomi	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

Vedi anche

Msvm_VirtualSystemManagementService

Condividi tramite