Méthode DefineSystem de la _ classe VirtualSystemManagementService MSVM
Crée une instance de machine virtuelle. Les propriétés qui ne sont pas spécifiées sont remplies avec les valeurs par défaut.
Syntaxe
uint32 DefineSystem(
[in] string SystemSettings,
[in] string ResourceSettings[],
[in] CIM_VirtualSystemSettingData REF ReferenceConfiguration,
[out] CIM_ComputerSystem REF ResultingSystem,
[out] CIM_ConcreteJob REF Job
);
Paramètres
-
SystemSettings [ dans]
-
Type : chaîne
Une instance incorporée de la classe MSVM _ VirtualSystemSettingData utilisée pour définir les attributs de l’ordinateur virtuel à créer. Ce paramètre est obligatoire.
-
ResourceSettings [ dans]
-
Type : chaîne [ ]
Nombre d’instances incorporées de la classe MSVM _ ResourceAllocationSettingData (ou classes dérivées de celles-ci). Ensemble, ces instances décrivent les ressources virtuelles de l’ordinateur virtuel. Un ensemble d’appareils par défaut sera créé pour l’ordinateur virtuel, que ce paramètre soit défini ou non. Par exemple, le processeur et la mémoire sont automatiquement créés et configurés avec les valeurs par défaut.
-
ReferenceConfiguration [ dans]
-
Type : CIM _ VirtualSystemSettingData
Référence à une instance de la classe MSVM _ VirtualSystemSettingData qui est l’objet de niveau supérieur d’une configuration d’ordinateur virtuel de référence. La configuration de référence est utilisée pour compléter la configuration du nouvel ordinateur virtuel si les paramètres SystemSettings et ResourceSettings n’ont pas fourni d’informations respectives.
-
ResultingSystem [ à]
-
Type : CIM _ CIM
Référence à une instance de la classe CIM _ CIM qui représente l’ordinateur virtuel nouvellement créé.
-
Travail [ à]
-
Type : CIM _ ConcreteJob
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
Type : UInt32
Si cette méthode est exécutée de façon synchrone, elle retourne 0 si elle réussit. Si cette méthode est exécutée de façon asynchrone, elle retourne 4096 et le paramètre de sortie de la tâche peut être utilisé pour suivre la progression de l’opération asynchrone. Toute autre valeur de retour indique une erreur.
-
Terminé sans erreur (0)
-
Non pris en charge (1)
-
Échec (2)
-
Délai d’expiration (3)
-
Paramètre non valide (4)
-
DMTF réservé (..)
-
Paramètres de méthode activés-tâche démarrée (4096)
-
Méthode réservée (4097.. 32767)
-
Spécifique au fournisseur (32768.. 65535)
Remarques
L’accès à la classe MSVM _ VirtualSystemManagementService peut être limité par le filtrage UAC. Pour plus d’informations, consultez contrôle de compte d’utilisateur et WMI.
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 |
|
| DLL |
|