Partager via

classe Msvm_EmulatedEthernetPortSettingData

  • Article

Représente l’état configuré d’une carte Ethernet émulée.

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_EmulatedEthernetPortSettingData : CIM_EthernetPortAllocationSettingData
{
  string  Caption = "Ethernet Port";
  string  Description = "Settings for the Microsoft Emulated Ethernet Port";
  string  InstanceID = "Microsoft:VMID\VDID\device-specific-data";
  string  ElementName = "Ethernet Port";
  uint16  ResourceType = 10;
  string  OtherResourceType;
  string  ResourceSubType = "Microsoft Emulated Ethernet Port";
  string  PoolID;
  uint16  ConsumerVisibility = 3;
  string  HostResource[];
  string  AllocationUnits = "Ports";
  uint64  VirtualQuantity = 1;
  uint64  Reservation = 1;
  uint64  Limit = 1;
  uint32  Weight = 0;
  boolean AutomaticAllocation = True;
  boolean AutomaticDeallocation = True;
  string  Parent;
  string  Connection[];
  string  Address;
  uint16  MappingBehavior;
  string  AddressOnParent;
  string  VirtualQuantityUnits = "count";
  uint16  DesiredVLANEndpointMode;
  string  OtherEndpointMode;
  boolean StaticMacAddress = TRUE;
  boolean ClusterMonitored = TRUE;
};

Membres

La classe Msvm_EmulatedEthernetPortSettingData a les types de membres suivants :

Propriétés

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

Adresse

Type de données : chaîne

Type d'accès : Lecture seule

Adresse de la ressource. Par exemple, l’adresse MAC d’un port Ethernet. Cette propriété est héritée de CIM_ResourceAllocationSettingData.

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 .

AddressOnParent

Type de données : chaîne

Type d'accès : Lecture seule

Décrit l’adresse de cette ressource dans le contexte du parent. Les propriétés Parent et AddressOnParent sont utilisées pour décrire la relation de contrôleur ainsi que l’ordre des appareils sur un contrôleur. Cette propriété est héritée de CIM_ResourceAllocationSettingData.

AllocationUnits

Type de données : chaîne

Type d'accès : Lecture seule

Unités d’allocation utilisées par les propriétés Reservation et Limit . Cette propriété est héritée de CIM_ResourceAllocationSettingData et elle est toujours définie sur « Ports ».

AutomaticAllocation

Type de données : booléen

Type d'accès : Lecture seule

Indique si la ressource sera automatiquement allouée. Cette propriété est héritée de CIM_ResourceAllocationSettingData et elle est toujours définie sur True.

AutomaticDeallocation

Type de données : booléen

Type d'accès : Lecture seule

Indique si la ressource sera automatiquement libérée. Cette propriété est héritée de CIM_ResourceAllocationSettingData et elle est toujours définie sur True.

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 elle est toujours définie sur « Port Ethernet ».

ClusterMonitored

Type de données : booléen

Type d'accès : Lecture seule

Indique si cette carte Ethernet est surveillée par un cluster. Cette propriété prend par défaut la valeur true si elle n’est pas configurée.

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 .

Windows 8.1 : cette valeur n’est pas prise en charge tant que Windows 8.1 et Windows Server 2012 R2.

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. Cette propriété est héritée de CIM_ResourceAllocationSettingData.

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 .

ConsumerVisibility

Type de données : uint16

Type d'accès : Lecture seule

Décrit la visibilité des consommateurs sur la ressource allouée. Cette propriété est héritée de CIM_ResourceAllocationSettingData, et elle est toujours définie sur 3 (virtualisé).

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 elle est toujours définie sur « Paramètres pour le port Ethernet émulé Microsoft ».

DesiredVLANEndpointMode

Type de données : uint16

Type d'accès : Lecture seule

Mode de configuration souhaité pour le point de terminaison VLAN. Cette propriété permet de définir la valeur initiale de la propriété OperationalEndpointMode dans la instance de Msvm_VLANEndpoint classe associée au port Ethernet ciblé. Pour connaître les valeurs possibles, consultez la propriété OperationalEndpointMode de la classe Msvm_VLANEndpoint . Cette propriété est héritée de CIM_EthernetPortAllocationSettingData.

ElementName

Type de données : chaîne

Type d'accès : Lecture seule

Nom d’affichage configurable par l’utilisateur pour l’appareil à lequel cette instance RASD est associée. Cette propriété est héritée de CIM_SettingData et elle est définie sur « Port Ethernet ». La modification de cette propriété modifie le nom de l’élément dérivé de l’appareil logique associé.

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 .

HostResource

Type de données : tableau de chaînes

Type d'accès : Lecture seule

Cette propriété est héritée de CIM_ResourceAllocationSettingData, et elle est toujours définie sur Null.

InstanceID

Type de données : chaîne

Type d'accès : Lecture seule

Dans l’étendue de l’espace de noms instanciant, InstanceID identifie de manière opaque et unique un instance de cette classe. Cette propriété est héritée de CIM_SettingData, et elle est toujours définie sur « Microsoft:VMIDVDID-specific-device-data\\ ».

Limite

Type de données : uint64

Type d'accès : Lecture seule

Limite supérieure ou quantité maximale de ressource qui sera accordée pour cette allocation. Cette propriété est héritée de CIM_ResourceAllocationSettingData, et elle est toujours définie sur 1.

MappingBehavior

Type de données : uint16

Type d'accès : Lecture seule

Spécifie la façon dont cette ressource est mappée aux ressources sous-jacentes. Cette propriété est héritée de CIM_ResourceAllocationSettingData et est toujours définie sur Null.

OtherEndpointMode

Type de données : chaîne

Type d'accès : Lecture seule

Chaîne qui décrit le type de modèle de point de terminaison VLAN pris en charge par ce point de terminaison VLAN. Cette propriété est utilisée uniquement lorsque la propriété DesiredVLANEndpointMode a la valeur 1 (Autre). Cette propriété doit avoir la valeur Null lorsque la propriété DesiredVLANEndpointMode a une valeur autre que 1. Cette propriété est héritée de CIM_EthernetPortAllocationSettingData.

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 est défini sur 0 (« Autre »). Cette propriété est héritée de CIM_ResourceAllocationSettingData et n’est pas utilisée.

Parent

Type de données : chaîne

Type d'accès : Lecture seule

Parent de la ressource. Par exemple, un contrôleur pour l’allocation actuelle. Cette propriété est héritée de CIM_ResourceAllocationSettingData.

PoolID

Type de données : chaîne

Type d'accès : Lecture seule

Le pool à partir duquel la ressource est actuellement allouée, ou le pool à partir duquel la ressource est allouée lorsque l’allocation se produit. Cette propriété est héritée de CIM_ResourceAllocationSettingData.

Réservation

Type de données : uint64

Type d'accès : Lecture seule

Quantité de ressources dont la disponibilité est garantie pour cette allocation. Sur les systèmes qui prennent en charge le sur-engagement des ressources, cette valeur est généralement utilisée pour le contrôle d’admission afin d’empêcher l’acceptation d’une allocation. Cette propriété est héritée de CIM_ResourceAllocationSettingData et est toujours définie sur 1.

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 cette ressource. 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_ResourceAllocationSettingData et est toujours définie sur « Port Ethernet émulé Microsoft ».

ResourceType

Type de données : uint16

Type d'accès : Lecture seule

Type de ressource auquel ce paramètre s’applique. Cette propriété est héritée de CIM_ResourceAllocationSettingData et est toujours définie sur 10 (adaptateur Ethernet).

StaticMacAddress

Type de données : booléen

Type d'accès : Lecture seule

Indique s’il faut utiliser une adresse MAC statique.

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 .

VirtualQuantity

Type de données : uint64

Type d'accès : Lecture seule

Quantité de ressources présentées au consommateur. Cette propriété est héritée de CIM_ResourceAllocationSettingData et est toujours définie sur 1.

VirtualQuantityUnits

Type de données : chaîne

Type d'accès : Lecture seule

Spécifie l’unité de mesure pour cette allocation de ressources. La valeur de cette propriété doit être une valeur juridique du qualificateur d’unités programmatiques tel que défini dans l’annexe C.1 de DSP0004 V2.5 ou version ultérieure. Cette propriété est héritée de CIM_ResourceAllocationSettingData.

Poids

Type de données : uint32

Type d'accès : Lecture seule

Priorité relative pour cette allocation par rapport aux autres allocations du même pool de ressources. Cette propriété est héritée de CIM_ResourceAllocationSettingData et est toujours définie sur 0.

Notes

L’accès à la classe Msvm_EmulatedEthernetPortSettingData peut être limité par le filtrage de contrôle d’utilisateur. Pour plus d’informations, consultez Contrôle de compte d’utilisateur et WMI.

Exemples

Consultez Interrogation d’objets de mise en réseau.

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_EthernetPortAllocationSettingData

CIM_ResourceAllocationSettingData