Méthode RealizePlannedSystem de la _ classe VirtualSystemManagementService MSVM

Valide la configuration d’un ordinateur virtuel planifié et le convertit en ordinateur virtuel réalisé. Les fichiers d’État du runtime ou de l’état enregistré associés à l’ordinateur virtuel seront copiés du répertoire d’importation vers la racine des données de l’ordinateur virtuel, le cas échéant.

Syntaxe

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

Paramètres

PlannedSystem [ dans]

Référence à l’instance MSVM _ PlannedComputerSystem qui doit être convertie en ordinateur virtuel réalisé.

ResultingSystem [ à]

Si l’opération est terminée de façon synchrone, il s’agit d’une référence à un objet _ ComputerSystem CIM qui représente l’ordinateur virtuel réalisé résultant.

type de données mis à jour à partir de Msvm _ ComputerSystem dans Windows 10, version 1703.

Travail [ à]

Si l’opération est effectuée de façon asynchrone, cette méthode retourne 4096 et ce paramètre contient une référence à un objet dérivé de CIM _ ConcreteJob.

Valeur retournée

Cette méthode retourne l’une des valeurs suivantes.

Terminé sans erreur (0)

Paramètres de méthode activés-tâche démarrée (4096)

Échec (32768)

Accès refusé (32769)

Non pris en charge (32770)

État inconnu (32771)

Délai d’expiration (32772)

Paramètre non valide (32773)

Le système est en cours d’utilisation (32774)

État non valide pour cette opération (32775)

Type de données incorrect (32776)

Le système n’est pas disponible (32777)

Mémoire insuffisante (32778)

Exemples

L’exemple C# suivant utilise la méthode RealizePlannedSystem pour réaliser un ordinateur virtuel planifié. Ce code est extrait de l' exemple de machines virtuelles planifiées Hyper-V. Les utilitaires référencés se trouvent dans les utilitaires courants pour les exemples de virtualisation (v2).

Important

Pour fonctionner correctement, le code suivant doit être exécuté sur le serveur hôte de l’ordinateur virtuel et doit être exécuté avec des privilèges d’administrateur.

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

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows 8 [ applications de bureau uniquement]
Serveur minimal pris en charge
Windows Server 2012 [ applications de bureau uniquement]
Espace de noms
\Virtualisation racine \ v2
MOF
WindowsVirtualization. v2. mof
DLL
Vmms.exe

Voir aussi

MSVM _ VirtualSystemManagementService