ValidatePlannedSystem-Methode der Msvm_VirtualSystemManagementService Klasse

Artikel
01/28/2024

Überprüft das angegebene geplante System. Dies umfasst Überprüfungen der virtuellen Computerkonfiguration, Geräte, Momentaufnahmekonfiguration, Momentaufnahmegeräte, gespeicherte Zustandsdateien und Speicherdateien.

Syntax

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

Parameter

PlanSystem [in]: Ein Verweis auf ein Msvm_PlannedComputerSystem -Objekt, das das geplante System darstellt, das überprüft werden soll.
Auftrag [out]: Wenn der Vorgang asynchron ausgeführt wird, gibt diese Methode 4096 zurück, und dieser Parameter enthält einen Verweis auf ein von CIM_ConcreteJob abgeleitetes Objekt.

Rückgabewert

Diese Methode gibt einen der folgenden Werte zurück.

Abgeschlossen ohne Fehler (0)
Methodenparameter überprüft – Auftrag gestartet (4096)
Fehler (32768)
Zugriff verweigert (32769)
Nicht unterstützt (32770)
Status ist unbekannt (32771)
Timeout (32772)
Ungültiger Parameter (32773)
System wird verwendet (32774)
Ungültiger Zustand für diesen Vorgang (32775)
Falscher Datentyp (32776)
System ist nicht verfügbar (32777)
Arbeitsspeicher außerhalb des Arbeitsspeichers (32778)
Datei in Verwendung (32779)

Beispiele

Im folgenden C#-Beispiel wird die ValidatePlannedSystem-Methode verwendet, um einen geplanten virtuellen Computer zu überprüfen. Dieser Code wird aus dem Beispiel für geplante virtuelle Hyper-V-Computer verwendet. Die referenzierten Hilfsprogramme finden Sie in allgemeinen Dienstprogrammen für die Virtualisierungsbeispiele (V2)..

Wichtig

Um ordnungsgemäß zu funktionieren, muss der folgende Code auf dem Hostserver des virtuellen Computers ausgeführt werden und mit Administratorrechten ausgeführt werden.

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

Requirements (Anforderungen)

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Namespace	Stamm\Virtualisierung\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

Weitere Informationen

Msvm_VirtualSystemManagementService

Freigeben über