Msvm_VirtualSystemManagementService classe
Représente le service de virtualisation présent sur un système hôte unique. Msvm_VirtualSystemManagementService est utilisé pour contrôler la définition, la modification et la suppression des machines virtuelles. Il propose également des méthodes pour effectuer des opérations sur des machines virtuelles, telles que le clonage, la capture instantanée et l’importation ou l’exportation de machines virtuelles. Pour récupérer des informations par machine virtuelle, utilisez Msvm_ComputerSystem.
La syntaxe suivante est le code MOF (Managed Object Format) simplifié et inclut toutes les propriétés héritées.
Syntaxe
[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_VirtualSystemManagementService : CIM_VirtualSystemManagementService
{
string InstanceID;
string Caption = "Virtual System Management Service";
string Description = "Service for creating, manipulating, and managing virtual machines";
string ElementName = "Hyper-V Virtual System Management Service";
datetime InstallDate;
string Name = "vmms";
uint16 OperationalStatus[] = { 2 };
string StatusDescriptions[] = { "The service is running normally" };
string Status;
uint16 HealthState = 5;
uint16 CommunicationStatus;
uint16 DetailedStatus;
uint16 OperatingStatus;
uint16 PrimaryStatus;
uint16 EnabledState = 2;
string OtherEnabledState;
uint16 RequestedState = 12;
uint16 EnabledDefault = 2;
datetime TimeOfLastStateChange;
uint16 AvailableRequestedStates[];
uint16 TransitioningToState;
string SystemCreationClassName = "Msvm_ComputerSystem";
string SystemName;
string CreationClassName = "Msvm_VirtualSystemManagementService";
string PrimaryOwnerName;
string PrimaryOwnerContact;
string StartMode;
boolean Started = True;
};
Membres
La classe Msvm_VirtualSystemManagementService a les types de membres suivants :
Méthodes
La classe Msvm_VirtualSystemManagementService a ces méthodes.
| Méthode | Description |
|---|---|
| AddBootSourceSettings | Ajoute des sources de démarrage à une configuration de système virtuel lorsqu’elle est appliquée à une configuration de système virtuel « d’état ». |
| AddFeatureSettings | Ajoute les paramètres de fonctionnalité Ethernet à la configuration d’une connexion Ethernet de machine virtuelle. |
| AddFibreChannelChap | Ajoute des paramètres DH-CHAP à un port Fibre Channel synthétique dans une machine virtuelle. |
| AddGuestServiceSettings | Ajoute les paramètres du service invité à une configuration de système virtuel. En cas d’application à des parties d’une configuration de système virtuel « actuelle », les services invités à effet secondaire du système virtuel actif peuvent être modifiés. |
| AddKvpItems | Ajoute des paires clé-valeur à une machine virtuelle. |
| AddResourceSettings | Ajoute des ressources à une configuration de machine virtuelle. |
| AddSystemComponentSettings | Ajoute des paramètres génériques à une configuration de système virtuel. |
| DefinePlannedSystem | Définit un système virtuel planifié. L’entrée qui n’est pas complètement spécifiée peut être remplie avec des valeurs par défaut. |
| DefineSystem | Crée une définition de machine virtuelle. |
| DestroySystem | Supprime une définition de machine virtuelle existante. |
| DiagnostiquerNetworkConnection | Diagnostique la connectivité réseau d’une machine virtuelle dans un environnement de virtualisation réseau Windows. |
| ExportSystemDefinition | Exporte une machine virtuelle, ou un instantané d’une machine virtuelle, vers un fichier. |
| FormatError | Retourne une chaîne de message d’erreur mise en forme pour le tableau spécifié d’instances incorporées Msvm_Error . |
| GenerateWwpn | Génère un ensemble de noms de ports mondiaux (WWPN). |
| GetCurrentWwpnFromGenerator | Permet d’afficher un aperçu du WWPN (World Wide Port Name) actuel sans que le WWPN soit réservé. |
| GetDefinitionFileSummaryInformation | Retourne des informations récapitulatives de machine virtuelle pour les fichiers de définition de machine virtuelle spécifiés. |
| GetSizeOfSystemFiles | Récupère la taille totale des fichiers système de la machine virtuelle. |
| GetSummaryInformation | Retourne des informations récapitulatives sur la machine virtuelle. |
| GetVirtualSystemThumbnailImage | Récupère une image miniature d’une machine virtuelle existante. |
| ImportSnapshotDefinitions | Recherche dans le dossier spécifié tous les fichiers de définition de instantané associés au système informatique planifié spécifié et crée un instantané sur le système informatique planifié pour chaque fichier de définition associé à cet emplacement. |
| ImportSystemDefinition | Crée un nouveau système informatique planifié basé sur la définition de machine virtuelle spécifiée. |
| ModifyDiskMergeSettings | Modifie les données du paramètre de fusion de disque. |
| ModifyFeatureSettings | Modifie les paramètres de fonctionnalité actuels d’une connexion Ethernet de machine virtuelle. |
| ModifyGuestServiceSettings | Modifie les paramètres du service invité. En cas d’application à des parties d’une configuration de système virtuel « actuelle », les services invités à effet secondaire du système virtuel actif peuvent être modifiés. |
| ModifyKvpItems | Modifie les paires clé-valeur existantes sur une machine virtuelle. |
| ModifyResourceSettings | Modifie les paramètres des ressources virtuelles. |
| ModifyServiceSettings | Modifie les données de paramètre du service. |
| ModifySystemComponentSettings | Modifie les paramètres de composant système génériques. |
| ModifySystemSettings | Modifie les paramètres de la machine virtuelle. |
| RealizePlannedSystem | Valide la configuration d’une machine virtuelle planifiée et la convertit en machine virtuelle réalisée. |
| RemoveBootSourceSettings | Supprime les paramètres des ressources virtuelles d’une configuration de système virtuel. Lorsqu’elle est appliquée à des parties d’une configuration de système virtuel « actuelle », les ressources à effet secondaire du système virtuel actif peuvent être supprimées. |
| RemoveFeatureSettings | Supprime les paramètres des fonctionnalités d’une connexion Ethernet de machine virtuelle. |
| RemoveFibreChannelChap | Supprime les paramètres DH-CHAP d’un port Fibre Channel synthétique dans une machine virtuelle. |
| RemoveGuestServiceSettings | Supprime les paramètres du service invité d’une configuration de système virtuel. En cas d’application à des parties d’une configuration de système virtuel « actuelle », les services invités à effet secondaire du système virtuel actif peuvent être modifiés. |
| RemoveKvpItems | Supprime les paires clé-valeur existantes d’une machine virtuelle. |
| RemoveResourceSettings | Supprime les paramètres de ressources virtuelles d’une configuration de machine virtuelle. |
| RemoveSystemComponentSettings | Supprime les paramètres de composant génériques d’une configuration de système virtuel. |
| RequestStateChange | Cette méthode n'est pas prise en charge. |
| SetGuestNetworkAdapterConfiguration | Configure les cartes réseau dans le système d’exploitation invité. |
| SetInitialMachineConfigurationData | Définit les données de configuration initiale d’une machine virtuelle. |
| StartService | Cette méthode n'est pas prise en charge. |
| StopService | Cette méthode n'est pas prise en charge. |
| TestNetworkConnection | Teste la connectivité réseau d’une machine virtuelle dans un environnement de virtualisation de réseau Windows. |
| UpgradeSystemVersion | Met à niveau le système virtuel. En cas d’application aux paramètres système d’une configuration de système virtuel « actuelle » |
| ValidatePlannedSystem | Valide le système planifié spécifié. |
Propriétés
La classe Msvm_VirtualSystemManagementService a ces propriétés.
-
AvailableRequestedStates
-
-
Type de données : tableau uint16
-
Type d'accès : Lecture seule
Indique les valeurs possibles pour le paramètre RequestedState de la méthode RequestStateChange . Cette propriété est héritée de CIM_EnabledLogicalElement et est toujours définie sur Null.
-
-
Caption
-
-
Type de données : Chaîne
-
Type d'accès : Lecture seule
Brève description de l’objet. Cette propriété est héritée de CIM_ManagedElement et est toujours définie sur « Service de gestion de système virtuel Hyper-V ».
-
-
CommunicationStatus
-
-
Type de données : uint16
-
Type d'accès : Lecture seule
Indique la capacité de l’instrumentation à communiquer avec l’élément managé sous-jacent. Une valeur Null indique que cette propriété n’est pas implémentée. Cette propriété est héritée de CIM_ManagedSystemElement.
-
Inconnu (0)
-
Non disponible (1)
-
Communication OK (2)
-
Perte de communication (3)
-
Aucun contact (4)
-
DMTF Reserved (..)
-
Fournisseur réservé (0x8000.. )
-
-
CreationClassName
-
-
Type de données : Chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : Key, MaxLen ( 256 )
Nom de la classe ou de la sous-classe utilisée dans la création d’un instance. Cette propriété est héritée de CIM_Service et est toujours définie sur « Msvm_VirtualSystemManagementService ».
-
-
Description
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Description de l'objet . Cette propriété est héritée de CIM_ManagedElement et est toujours définie sur « Service pour la création, la manipulation et la gestion des machines virtuelles ».
-
-
DetailedStatus
-
-
Type de données : uint16
-
Type d'accès : Lecture seule
Complète la propriété PrimaryStatus avec des détails status supplémentaires. Une valeur Null indique que cette propriété n’est pas implémentée. Cette propriété est héritée de CIM_ManagedSystemElement.
-
Non disponible (0)
-
Aucune information supplémentaire (1)
-
Stressé (2)
-
Échec prédictif (3)
-
Erreur non récupérable (4)
-
Entité de prise en charge en erreur (5)
-
DMTF Reserved (..)
-
Fournisseur réservé (0x8000.. )
-
-
ElementName
-
-
Type de données : Chaîne
-
Type d'accès : Lecture seule
Nom complet de l’objet. Cette propriété est héritée de CIM_ManagedElement et est toujours définie sur « Service de gestion de système virtuel Hyper-V ».
-
-
EnabledDefault
-
-
Type de données : uint16
-
Type d'accès : Lecture seule
Configuration par défaut ou de démarrage d’un administrateur pour l’état activé d’un élément. Cette propriété est héritée de CIM_EnabledLogicalElement et est toujours définie sur 2 (Activé).
Valeur Signification - 2
activé -
-
EnabledState
-
-
Type de données : uint16
-
Type d'accès : Lecture seule
États activés et désactivés d’un élément. Cette propriété peut également indiquer les transitions entre ces états demandés. Cette propriété est héritée de CIM_EnabledLogicalElement et est toujours définie sur 2 (Activé).
Valeur Signification - 2
activé -
-
HealthState
-
-
Type de données : uint16
-
Type d'accès : Lecture seule
Intégrité actuelle de l’élément. Cet attribut exprime l’intégrité de cet élément, mais pas nécessairement celle de ses sous-composants. Les valeurs possibles sont comprises entre 0 et 30, où 5 signifie que l’élément est entièrement sain et 30 signifie que l’élément est complètement non fonctionnel. Cette propriété est héritée de CIM_ManagedSystemElement et est toujours définie sur 5 (OK).
Valeur Signification - 5
La status d’intégrité est normale. -
-
InstallDate
-
-
Type de données : datetime
-
Type d'accès : Lecture seule
Date et heure de création de la configuration de la machine virtuelle. Cette propriété est héritée de CIM_ManagedSystemElement.
-
-
InstanceID
-
-
Type de données : Chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : Clé
Identifie de manière unique un instance de cette classe. Cette propriété est héritée de CIM_ManagedElement.
-
-
Nom
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : Key, MaxLen ( 256 )
Étiquette par laquelle l’objet est connu. Cette propriété est héritée de CIM_ManagedSystemElement et elle est toujours définie sur « vmms ».
-
-
OperatingStatus
-
-
Type de données : uint16
-
Type d'accès : Lecture seule
Fournit des informations status actuelles pour la condition opérationnelle de l’élément et peut être utilisée pour fournir plus de détails concernant la valeur de la propriété EnabledState. Une valeur Null indique que cette propriété n’est pas implémentée. Cette propriété est héritée de CIM_ManagedSystemElement.
-
Inconnu (0)
-
Non disponible (1)
-
Maintenance (2)
-
Début (3)
-
Arrêt (4)
-
Arrêté (5)
-
Abandonné (6)
-
Dormant (7)
-
Terminé (8)
-
Migration (9)
-
Émigrant (10)
-
Immigrer (11)
-
Capture instantanée (12)
-
Arrêt ( 13)
-
Dans Test (14)
-
Transition ( 15)
-
Dans Service (16)
-
DMTF réservé (..)
-
Fournisseur réservé (0x8000.. )
-
-
OperationalStatus
-
-
Type de données : uint16 array
-
Type d'accès : Lecture seule
État actuel de l’objet. Cette propriété est héritée de CIM_ManagedSystemElement, et chaque élément de tableau est toujours défini sur 2 (OK).
-
-
OtherEnabledState
-
-
Type de données : Chaîne
-
Type d'accès : Lecture seule
Chaîne qui décrit l’état activé ou désactivé de l’élément lorsque la propriété EnabledState a la valeur 1 (« Autre »). Cette propriété doit avoir la valeur Null lorsque EnabledState a une valeur autre que 1. Cette propriété est héritée de CIM_EnabledLogicalElement et elle est toujours définie sur Null.
-
-
PrimaryOwnerContact
-
-
Type de données : Chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MaxLen ( 256 )
Toutes les informations sur la façon dont le propriétaire principal du service peut être joint (par exemple, numéro de téléphone, adresse e-mail, etc.). Cette propriété est héritée de CIM_Service, et elle est toujours définie sur Null.
-
-
PrimaryOwnerName
-
-
Type de données : Chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MaxLen ( 64 )
Nom du propriétaire principal du service, le cas échéant. Le propriétaire principal est le contact de support initial pour le service. Cette propriété est héritée de CIM_Service, et elle est toujours définie sur Null.
-
-
PrimaryStatus
-
-
Type de données : uint16
-
Type d'accès : Lecture seule
Fournit des informations de status de haut niveau. Cette propriété doit être utilisée conjointement avec la propriété DetailedStatus pour fournir un status d’intégrité de haut niveau et détaillé de l’élément et de ses sous-composants. Une valeur Null indique que cette propriété n’est pas implémentée. Cette propriété est héritée de CIM_ManagedSystemElement.
-
Inconnu (0)
-
OK (1)
-
Dégradé ( 2)
-
Erreur (3)
-
DMTF réservé (..)
-
Fournisseur réservé (0x8000.. )
-
-
RequestedState
-
-
Type de données : uint16
-
Type d'accès : Lecture seule
Dernier état demandé ou souhaité pour l’élément. L’état réel de l’élément est représenté par EnabledState. Cette propriété est fournie pour comparer les derniers états demandés et actuels d’un élément. Une instance particulière de la classe CIM_EnabledLogicalElement peut ne pas prendre en charge la propriété RequestedState. Si cela se produit, la valeur 12 (« Non applicable ») est utilisée. Cette propriété est héritée de CIM_EnabledLogicalElement, et elle est toujours définie sur 12 (Non applicable).
Valeur Signification - 12
Non applicable. -
-
Get Started with Custom Speech Service (Prise en main de Custom Speech Service)
-
-
Type de données : booléen
-
Type d'accès : Lecture seule
Indique si le service est en cours d’exécution. Cette propriété est héritée de CIM_Service et elle est toujours définie sur True.
-
-
StartMode
-
-
Type de données : Chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MaxLen ( 10 )
Valeur de chaîne qui indique si le service est démarré automatiquement par un système, un système d’exploitation ou s’il est démarré uniquement à la demande. Cette propriété est héritée de CIM_Service, et elle est toujours définie sur Null.
-
-
État
-
-
Type de données : Chaîne
-
Type d'accès : Lecture seule
Cette propriété est héritée de CIM_ManagedSystemElement, mais elle n’est pas utilisée.
-
-
StatusDescriptions
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Chaînes qui décrivent les différentes valeurs du tableau OperationalStatus . Cette propriété est héritée de CIM_ManagedSystemElement, et chaque élément de tableau est toujours défini sur « Le service s’exécute normalement ».
-
-
SystemCreationClassName
-
-
Type de données : Chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : Key, MaxLen ( 256 )
Nom de la classe de création du système d’étendue. Cette propriété est héritée de CIM_Service et elle est toujours définie sur « Msvm_ComputerSystem ».
-
-
SystemName
-
-
Type de données : Chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : Key, MaxLen ( 256 )
Nom NetBIOS du système informatique d’hébergement. Cette propriété est héritée de CIM_Service.
-
-
TimeOfLastStateChange
-
-
Type de données : datetime
-
Type d'accès : Lecture seule
Date ou heure de la dernière modification de l’état activé de l’élément. Cette propriété est héritée de CIM_EnabledLogicalElement.
-
-
TransitioningToState
-
-
Type de données : uint16
-
Type d'accès : Lecture seule
Indique l’état cible vers lequel le instance effectue la transition. Cette propriété est héritée de CIM_EnabledLogicalElement et elle est toujours définie sur Null.
-
Notes
L’accès à la classe Msvm_VirtualSystemManagementService peut être restreint 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 |
Racine\Virtualisation\V2 |
| MOF |
|
| DLL |
|