Msvm_GuestServiceInterfaceComponentSettingData class

Article
10/13/2023

Représente l’état configuré du composant d’interface du service invité. Cette classe dérive de la classe CIM_ResourceAllocationSettingData.

La syntaxe suivante est simplifiée à partir du code MOF et inclut toutes les propriétés héritées.

Syntaxe

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_GuestServiceInterfaceComponentSettingData : CIM_ResourceAllocationSettingData
{
  string  ElementName;
  string  InstanceID;
  uint16  ResourceType;
  string  OtherResourceType;
  string  ResourceSubType;
  string  PoolID;
  uint16  ConsumerVisibility;
  string  HostResource[];
  string  AllocationUnits;
  uint64  VirtualQuantity;
  uint64  Reservation;
  uint64  Limit;
  uint32  Weight;
  boolean AutomaticAllocation;
  boolean AutomaticDeallocation;
  string  Parent;
  string  Connection[];
  string  Address;
  uint16  MappingBehavior;
  uint16  EnabledState = 3;
  uint16  DefaultEnabledStatePolicy = 2;
};

Membres

La classe Msvm_GuestServiceInterfaceComponentSettingData possède les types de membres suivants :

Propriétés

Propriétés

La classe Msvm_GuestServiceInterfaceComponentSettingData possède ces propriétés.

Adresse

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

L'adresse de la ressource. Par exemple, l'adresse MAC d'un port Ethernet.

AllocationUnits

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

Cette propriété spécifie les unités d'allocation utilisées par les propriétés Réservation et Limite. Par exemple, lorsque ResourceType=Processor, AllocationUnits peut être défini sur MHz. Lorsque ResourceType=Memory, AllocationUnits peut être défini sur Mo

AutomaticAllocation

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

Cette propriété spécifie si la ressource sera automatiquement allouée. Par exemple, lorsqu'elle est définie sur true, lorsque le système informatique virtuel consommateur est allumé, cette ressource sera allouée. Une valeur false indique que la ressource doit être explicitement allouée. Par exemple, le paramètre peut représenter un support amovible (c'est-à-dire un CD-ROM ou une disquette) sur lequel, au moment de la mise sous tension, le support n'est pas présent. Une opération explicite est requise pour allouer la ressource.

AutomaticDeallocation

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

Cette propriété spécifique si la ressource sera automatiquement désallouée. Par exemple, lorsqu'elle est définie sur true, lorsque le système informatique virtuel consommateur est mis hors tension, cette ressource est libérée. Lorsqu'elle est définie sur false, la ressource restera allouée et doit être explicitement désallouée.

Connection

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

La chose à laquelle cette ressource est connectée. Par exemple, un réseau nommé ou un port de commutateur.

ConsumerVisibility

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

Décrit la visibilité des consommateurs sur la ressource allouée.

Value	Signification
Unknown 0	Inconnu.
Passed-Through 2	La ressource sous-jacente ou hôte est utilisée et transmise au consommateur, éventuellement en utilisant le partitionnement. Au moins un élément doit être présent dans la propriété DeviceID.
Virtualisé 3	La ressource est virtualisée et peut ne pas être mappée directement à une ressource sous-jacente/hôte. Certaines implémentations peuvent prendre en charge une affectation spécifique pour les ressources virtualisées, auquel cas la ou les ressources hôte sont exposées à l'aide de la propriété DeviceID.
Non représenté 4	Une représentation de la ressource n’existe pas dans le contexte du consommateur de ressources.
DMTF réservé ..
Vendeur réservé 32767..65535

DefaultEnabledStatePolicy

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

Les états activés et désactivés des services de communication invité par défaut.

Il s'agit d'une propriété en lecture seule, mais elle peut être modifiée à l'aide de la méthode ModifyResourceSettings de la classe Msvm_VirtualSystemManagementService.

Remarque

Ajouté dans Windows 10.

Activé (2)

Désactivé (3)

ElementName

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

Nom d'affichage de cette instance de SettingData. De plus, le nom d'affichage peut être utilisé comme propriété d'index pour une recherche ou une requête. (Remarque : il n'est pas nécessaire que le nom soit unique dans un espace de noms.)

EnabledState

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

Les états activés et désactivés d'un élément.

Il s'agit d'une propriété en lecture seule, mais elle peut être modifiée à l'aide de la méthode ModifyVirtualSystemResources (ou ModifyResourceSettings dans Windows 10 ou version ultérieure) de la classe Msvm_VirtualSystemManagementService.

Les valeurs autorisées sont :

Activé (2)

Désactivé (3)

HostResource

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

Cette propriété expose une affectation spécifique aux ressources hôtes ou sous-jacentes. Les instances intégrées doivent contenir uniquement des propriétés clés et être traitées comme des chemins d'objet. Si la ressource virtuelle peut être planifiée sur un certain nombre de ressources sous-jacentes, cette propriété doit rester NULL. Dans ce cas, les associations DeviceAllocatedFromPool ou ResourceAllocationFromPool peuvent être utilisées pour déterminer le pool de ressources hôtes sur lequel cette ressource virtuelle peut être planifiée. Si une affectation spécifique est utilisée, toutes les ressources sous-jacentes utilisées par cette ressource virtuelle doivent être répertoriées dans ce tableau. Généralement, le tableau contient un élément, mais pour les allocations globales, telles que plusieurs processeurs, plusieurs ressources hôtes peuvent être spécifiées.

InstanceID

Type de données : chaîne
Type d'accès : Lecture seule
Qualificateurs : Key (clé)

Dans le cadre de l'espace de noms d'instanciation, InstanceID identifie de manière opaque et unique une instance de cette classe. Pour garantir l'unicité au sein de l'espace de noms, la valeur de InstanceID doit être construite à l'aide de l'algorithme « préféré » suivant : OrgID:LocalID Où OrgID et LocalID sont séparés par deux points (:), et où OrgID doit inclure un nom protégé par le droit d'auteur, une marque déposée ou autre. nom unique appartenant à l'entité commerciale qui crée ou définit l'InstanceID ou qui est un ID enregistré attribué à l'entité commerciale par une autorité mondiale reconnue. (Cette exigence est similaire à la structure SchemaName_ClassName des noms de classe Schema.) De plus, pour garantir l'unicité, OrgID ne doit pas contenir de deux-points (:). Lors de l'utilisation de cet algorithme, les premiers deux-points à apparaître dans InstanceID doivent apparaître entre OrgID et LocalID. LocalID est choisi par l'entité commerciale et ne doit pas être réutilisé pour identifier différents éléments sous-jacents (du monde réel). Si l'algorithme « préféré » ci-dessus n'est pas utilisé, l'entité de définition doit garantir que l'InstanceID résultant n'est pas réutilisé dans les InstanceID produits par ce fournisseur ou par d'autres pour l'espace de noms de cette instance. Pour les instances définies par DMTF, l'algorithme « préféré » doit être utilisé avec l'OrgID défini sur CIM.

Limite

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

Cette propriété spécifie la limite supérieure ou la quantité maximale de ressources qui sera accordée pour cette allocation. Par exemple, un système qui prend en charge la pagination de la mémoire peut prendre en charge la définition de la limite d'une allocation de mémoire inférieure à celle de la quantité virtuelle, forçant ainsi la pagination pour cette allocation.

MappingBehavior

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

Spécifie comment cette ressource est mappée aux ressources sous-jacentes. Si le tableau HostResource contient des entrées, cette propriété reflète la façon dont la ressource est mappée à ces ressources spécifiques.

Inconnu (0)
Non supporté (1)
Dédié (2)
Affinité douce (3)
Affinité dure (4)
DMTF réservé (..)
Vendeur réservé (32767..65535)

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 « Autre ».

Parent

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

Le parent de la ressource. Par exemple, un contrôleur pour l'allocation actuelle.

ID de pool

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

Cette propriété spécifie à partir de quel ResourcePool la ressource est actuellement allouée, ou à partir de quel ResourcePool la ressource sera allouée lorsque l'allocation se produit.

Réservation

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

Cette propriété spécifie la quantité de ressources dont la disponibilité est garantie pour cette allocation. Sur les systèmes prenant en charge le surengagement de ressources, cette valeur est généralement utilisée pour le contrôle d'admission afin d'empêcher l'acceptation d'une allocation, empêchant ainsi l'épuisement des ressources.

ResourceSubType

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

Chaîne décrivant un sous-type spécifique à l’implémentation pour cette ressource. Par exemple, cela peut être utilisé pour distinguer différents modèles du même type de ressource.

ResourceType

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

Type de ressource représenté par ce paramètre d’allocation.

Autre (1)
Système d'ordinateur (2)
Processeur (3)
Mémoire (4)
Contrôleur IDE (5)
HBA SCSI parallèle (6)
FC-HBA (7)
HBA iSCSI (8)
IB HCA (9)
Adaptateur Ethernet (10)
Autre adaptateur réseau (11)
Emplacement E/S (12)
Périphérique d'E/S (13)
Lecteur de disquette (14)
Lecteur CD (15)
lecteur DVD (16)
Port série (17)
Port parallèle (18)
Contrôleur USB (19)
Contrôleur graphique (20)
Étendue de stockage (21)
Azure Data Box Disk (22)
Bande (23)
Autre périphérique de stockage (24)
Contrôleur Firewire (25)
Unité partitionnable (26)
Unité de base partitionnable (27)
Source de courant (28)
Dispositif de refroidissement (29)
DMTF réservé (..)
Vendeur réservé (32767..65535)

VirtualQuantity

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

Cette propriété précise la quantité de ressources présentées au consommateur. Par exemple, lorsque ResourceType=Processor, cette propriété reflète le nombre de processeurs discrets présentés au système informatique virtuel. Lorsque ResourceType=Memory, cette propriété peut refléter le nombre de Mo signalé au système informatique virtuel.

Poids

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

Cette propriété spécifie une priorité relative pour cette allocation par rapport aux autres allocations du même ResourcePool. Cette propriété n'a pas d'unité de mesure et n'est pertinente que par rapport à d'autres allocations en concurrence pour les mêmes ressources hôtes.

Spécifications

Condition requise	Value
Client minimal pris en charge	Windows 8.1 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 R2 [applications de bureau uniquement]
Espace de noms	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

Voir aussi

CIM_ResourceAllocationSettingData
CIM_ResourceAllocationSettingData

Partager via