RealizePlannedSystem-Methode der Msvm_VirtualSystemManagementService-Klasse

Artikel
06/12/2023

Überprüft die Konfiguration eines geplanten virtuellen Computers und konvertiert ihn in einen realisierten virtuellen Computer. Alle laufzeit- oder gespeicherten Zustandsdateien, die dem virtuellen Computer zugeordnet sind, werden ggf. aus dem Importverzeichnis in den Datenstamm des virtuellen Computers kopiert.

Syntax

uint32 RealizePlannedSystem(
  [in]  Msvm_PlannedComputerSystem REF PlannedSystem,
  [out] CIM_ComputerSystem         REF ResultingSystem,
  [out] CIM_ConcreteJob            REF Job
);

Parameter

PlannedSystem [in]

Ein Verweis auf den Msvm_PlannedComputerSystem instance, der in einen realisierten virtuellen Computer konvertiert werden soll.

ResultSystem [out]

Wenn der Vorgang synchron abgeschlossen wird, ein Verweis auf ein CIM_ComputerSystem-Objekt , das den resultierenden realisierten virtuellen Computer darstellt.

Datentyp aktualisiert von Msvm_ComputerSystem in Windows 10 Version 1703.

Auftrag [out]

Wenn der Vorgang asynchron ausgeführt wird, gibt diese Methode 4096 zurück, und dieser Parameter enthält einen Verweis auf ein Objekt, das von CIM_ConcreteJob abgeleitet wurde.

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)
Das System wird verwendet (32774)
Ungültiger Status für diesen Vorgang (32775)
Falscher Datentyp (32776)
System ist nicht verfügbar (32777)
Nicht genügend Arbeitsspeicher (32778)

Beispiele

Im folgenden C#-Beispiel wird die RealizePlannedSystem-Methode verwendet, um einen geplanten virtuellen Computer zu realisieren. Dieser Code stammt aus dem Hyper-V-Beispiel für geplante virtuelle Computer. Die referenzierten Hilfsprogramme finden Sie unter Allgemeine Hilfsprogramme für die Virtualisierungsbeispiele (V2).

Wichtig

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

/// <summary>
/// Finds the first Planned VM matching pvmName and realizes it.
/// </summary>
/// <param name="pvmName">The name of the PVM to be realized.</param>
/// <returns>The Realized Virtual Machine.</returns>
internal static ManagementObject
RealizePvm(
    string pvmName
    )
{
    ManagementObject vm = null;
    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("RealizePlannedSystem"))
    {
        inParams["PlannedSystem"] = pvm.Path;

        Console.WriteLine("Realizing Planned Virtual Machine \"{0}\" ({1})...",
                pvm["ElementName"], pvm["Name"]);

        using (ManagementBaseObject outParams =
            managementService.InvokeMethod("RealizePlannedSystem", inParams, null))
        {
            if (WmiUtilities.ValidateOutput(outParams, scope, true, true))
            {
                using (ManagementObject job =
                    new ManagementObject((string)outParams["Job"]))
                using (ManagementObjectCollection pvmCollection =
                    job.GetRelated("Msvm_ComputerSystem",
                        "Msvm_AffectedJobElement", null, null, null, null, false, null))
                {
                    vm = WmiUtilities.GetFirstObjectFromCollection(pvmCollection);
                }
            }
        }
    }

    return vm;
}

Anforderungen

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

Siehe auch

Msvm_VirtualSystemManagementService

Freigeben über