Méthode DefineSystem de la classe Msvm_VirtualSystemManagementService

Crée une machine virtuelle instance. Les propriétés qui ne sont pas spécifiées sont remplies avec des 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 [in]

Type : chaîne

Une instance incorporée de la classe Msvm_VirtualSystemSettingData utilisée pour définir les attributs de la machine virtuelle à créer. Ce paramètre est obligatoire.

ResourceSettings [in]

Type : string[]

Un certain nombre d’instances incorporées de la classe Msvm_ResourceAllocationSettingData (ou des classes dérivées de celle-ci). Ensemble, ces instances décrivent les ressources virtuelles de la machine virtuelle. Un ensemble d’appareils par défaut est créé pour la machine virtuelle, 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 des valeurs par défaut.

ReferenceConfiguration [in]

Type : CIM_VirtualSystemSettingData

Référence à un instance de la classe Msvm_VirtualSystemSettingData qui est l’objet de niveau supérieur d’une configuration de machine virtuelle de référence. La configuration de référence est utilisée pour compléter la configuration de la nouvelle machine virtuelle si les paramètres SystemSettings et ResourceSettings ne fournissent pas d’informations respectives.

ResultingSystem [out]

Type : CIM_ComputerSystem

Référence à un instance de la classe CIM_ComputerSystem qui représente la machine virtuelle nouvellement créée.

Travail [out]

Type : CIM_ConcreteJob

Si l’opération est effectuée de manière 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 manière synchrone, elle retourne 0 si elle réussit. Si cette méthode est exécutée de manière asynchrone, elle retourne 4096 et le paramètre de sortie du travail peut être utilisé pour suivre la progression de l’opération asynchrone. Toute autre valeur de retour indique une erreur.

Terminé avec aucune erreur (0)

Non pris en charge (1)

Échec (2)

Délai d’expiration (3)

Paramètre non valide (4)

DMTF Reserved (..)

Paramètres de méthode vérifiés - Travail démarré (4096)

Méthode réservée (4097..32767)

Spécifique au fournisseur (32768..65535)

Notes

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.

Spécifications

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	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

Voir aussi

Msvm_VirtualSystemManagementService