Msvm_ResourcePool classe

Article
06/12/2023

Décrit un type de ressource virtuelle disponible pour une utilisation dans des machines virtuelles. Le pool de ressources agrège les ressources physiques et est utilisé pour allouer des ressources aux machines virtuelles. Dans Hyper-V, tous les pools de ressources sont primordials, et il existe exactement un pool pour chaque type de ressource spécifique qui peut être alloué à une machine virtuelle.

La syntaxe suivante est un code MOF (Managed Object Format) simplifié et inclut toutes les propriétés héritées.

Syntaxe

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_ResourcePool : CIM_ResourcePool
{
  string   InstanceID;
  string   Caption;
  string   Description;
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[];
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  string   PoolID = "Microsoft:GUID\Root";
  boolean  Primordial = False;
  uint64   Capacity;
  uint64   Reserved;
  uint16   ResourceType = 4;
  string   OtherResourceType;
  string   ResourceSubType;
  string   AllocationUnits = "Megabyte";
  string   ConsumedResourceUnits = "count";
  uint64   CurrentlyConsumedResource;
  uint64   MaxConsumableResource;
};

Membres

La classe Msvm_ResourcePool comporte les types de membres suivants :

Propriétés

Propriétés

La classe Msvm_ResourcePool a ces propriétés.

AllocationUnits

Type de données : chaîne
Type d'accès : Lecture seule

Unités d’allocation utilisées par le pool de ressources. Cette propriété est héritée de CIM_ResourcePool et est définie sur « Mégaoctet ».

Capacité

Type de données : uint64
Type d'accès : Lecture seule

Quantité maximale (en unités d’AllocationUnits) de réservations actives que le pool de ressources peut prendre en charge. Cette propriété est héritée de CIM_ResourcePool.

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.

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.. )

ConsumedResourceUnits

Type de données : chaîne
Type d'accès : Lecture seule

Spécifie les unités des propriétés MaxConsumableResource et CurrentlyConsumedResource .

ActuellementConsumedResource

Type de données : uint64
Type d'accès : Lecture seule

Spécifie la quantité de ressources que le pool de ressources présente actuellement aux consommateurs. Cette propriété est différente de la propriété Reserved en ce qu’elle décrit la vue des consommateurs de la ressource, tandis que la propriété Reserved décrit la vue producteurs de la ressource.

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.

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.

HealthState

Type de données : uint16
Type d'accès : Lecture seule

Intégrité actuelle de l’élément. Cette propriété est héritée de CIM_ManagedSystemElement.

InstallDate

Type de données : datetime
Type d'accès : Lecture seule

Date et heure d’installation de l’objet. Cette propriété n’a pas besoin d’une valeur pour indiquer que l’objet est installé. 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.

MaxConsumableResource

Type de données : uint64
Type d'accès : Lecture seule

Spécifie la quantité maximale de ressources consommables que le pool de ressources peut présenter aux consommateurs. Cette propriété est différente de la propriété Capacity en ce qu’elle décrit la vue des consommateurs de la ressource, tandis que la propriété Capacity décrit la vue des producteurs de la ressource.

Nom

Type de données : chaîne
Type d'accès : Lecture seule

Étiquette par laquelle l’objet est connu. Cette propriété est héritée de CIM_ManagedSystemElement.

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
Qualificateurs : Remplacer (« OperationalStatus »), ArrayType (« Indexed »)

État actuel de l’objet. Cette propriété est héritée de CIM_ManagedSystemElement.

Si aucune condition liée à QoS n’a été détectée, le status principal (OperationalStatus[0]) est défini sur OK (2). Sinon, le status primaire est défini sur Dégradé (3), et une ou plusieurs valeurs status secondaires sont renseignées dans le tableau, à partir de l’index 1, qui indiquent des conditions plus spécifiques, selon ce tableau.

Valeur	Description
Débit insuffisant (32788)	Au moins un des disques virtuels alloués à partir du pool signale actuellement un débit insuffisant status.

Le fournisseur WMI Hyper-V déclenche un événement Msvm_StorageAlert chaque fois que l’OperationalStatus de la classe Msvm_ResourcePool change.

OK (2)

Dégradé ( 3)

Erreur non récupérable (7)

Aucun contact (12)

Communication perdue (13)

Incompatibilité de protocole (32775)

Débit insuffisant (32788)

OtherResourceType

Type de données : chaîne
Type d'accès : Lecture seule

Chaîne qui décrit le type de ressource lorsqu’une valeur bien définie n’est pas disponible et que ResourceType a la valeur 0 (« Autre »). Cette propriété est héritée de CIM_ResourcePool et est définie sur Null.

PoolID

Type de données : chaîne
Type d'accès : Lecture seule

Cette valeur est référencée par les instances CIM_ResourceAllocationSettingData qui ont été allouées à partir de ce pool. Cette propriété est héritée de CIM_ResourcePool, et elle est toujours définie sur « Microsoft:GUID\Root ».

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.. )

Primordial

Type de données : booléen
Type d'accès : Lecture seule

True si ce pool de ressources est la base à partir de laquelle les ressources sont extraites et retournées dans l’activité de gestion des ressources ; sinon, False. Le fait d’être primordial signifie que ce pool de ressources ne peut pas être créé ou supprimé par les consommateurs de ce modèle. Toutefois, d’autres actions, modélisées ou non, peuvent affecter les caractéristiques ou la taille des pools de ressources primordials. Cette propriété est héritée de CIM_ResourcePool.

Reserved

Type de données : uint64
Type d'accès : Lecture seule

Les réservations actuelles (en unités d’AllocationUnits) sont réparties entre toutes les allocations actives de ce pool. Dans une configuration hiérarchique, cela représente la somme de toutes les réservations actuelles du pool de ressources descendantes. Cette propriété est héritée de CIM_ResourcePool.

ResourceSubType

Type de données : chaîne
Type d'accès : Lecture seule

Chaîne qui décrit un sous-type spécifique à l’implémentation pour ce pool. Par exemple, cela peut être utilisé pour distinguer différents modèles du même type de ressource. Cette propriété est héritée de CIM_ResourcePool.

ResourceType

Type de données : uint16
Type d'accès : Lecture seule

Type de ressource que ce pool de ressources peut allouer. Cette propriété est héritée de CIM_ResourcePool et est définie sur 4 (« Mémoire »).

État

Type de données : chaîne
Type d'accès : Lecture seule

Status actuelle de l’objet. Cette propriété est héritée de CIM_ManagedSystemElement, mais elle n’est pas utilisée.

StatusDescriptions

Type de données : tableau de chaînes
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.

Notes

L’accès à la classe Msvm_ResourcePool 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

CIM_ResourcePool
CIM_ResourcePool
Msvm_ResourcePool (V1)
Msvm_StorageAlert
Classes de gestion des ressources