MSVM _ SyntheticEthernetPortSettingData, classe
Représente l’état configuré d’une carte Ethernet synthétique.
La syntaxe suivante est simplifiée format MOF (MOF) et comprend toutes les propriétés héritées.
Syntaxe
[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_SyntheticEthernetPortSettingData : CIM_EthernetPortAllocationSettingData
{
string InstanceID;
string Caption = "Virtual Ethernet Port Default Settings";
string Description = "Describes the default settings for the virtual Ethernet port resources.";
string ElementName;
uint16 ResourceType = 10;
string OtherResourceType;
string ResourceSubType = "Microsoft:Hyper-V:Synthetic Ethernet Port";
string PoolID;
uint16 ConsumerVisibility = 3;
string HostResource[];
string AllocationUnits = "count";
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;
string VirtualSystemIdentifiers[];
boolean DeviceNamingEnabled = FALSE;
boolean AllowPacketDirect = FALSE;
boolean StaticMacAddress = False;
boolean ClusterMonitored = TRUE;
};
Membres
La classe MSVM _ SyntheticEthernetPortSettingData possède les types de membres suivants :
Propriétés
La classe MSVM _ SyntheticEthernetPortSettingData possède les propriétés suivantes.
-
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 la _ ResourceAllocationSettingData CIM.
-
-
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 du contrôleur, ainsi que l’ordre des appareils sur un contrôleur. Cette propriété est héritée de la _ ResourceAllocationSettingData CIM.
-
-
AllocationUnits
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Unités d’allocation utilisées par la réservation et les propriétés de la limite . Cette propriété est héritée de la _ ResourceAllocationSettingData CIM.
-
-
AllowPacketDirect
-
-
Type de données : booléen
-
Type d’accès : lecture/écriture
Indique si la projection d’un PacketDirect est activée pour la machine virtuelle.
Notes
ajouté dans Windows 10, version 1703 et Windows Server 2016.
-
-
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 la _ ResourceAllocationSettingData CIM.
-
-
AutomaticDeallocation
-
-
Type de données : booléen
-
Type d'accès : Lecture seule
Indique si la ressource sera automatiquement désallouée. Cette propriété est héritée de la _ ResourceAllocationSettingData CIM.
-
-
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 la _ propriété ManagedElement CIM.
-
-
ClusterMonitored
-
-
Type de données : booléen
-
Type d'accès : Lecture seule
Indique si cette carte Ethernet est surveillée par un cluster. La valeur par défaut de cette propriété est 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
Élément auquel cette ressource est connectée. Par exemple, un réseau nommé ou un port commuté. Cette propriété est héritée de la _ ResourceAllocationSettingData CIM.
-
-
ConsumerVisibility
-
-
Type de données : UInt16
-
Type d'accès : Lecture seule
Visibilité des consommateurs sur la ressource allouée. Cette propriété est héritée de CIM _ ResourceAllocationSettingDataet 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 la _ propriété ManagedElement CIM.
-
-
DesiredVLANEndpointMode
-
-
Type de données : UInt16
-
Type d'accès : Lecture seule
Mode de configuration souhaité pour le point de terminaison de réseau local virtuel. Cette propriété est utilisée pour définir la valeur de la propriété OperationalEndpointMode initiale dans l’instance de la classe MSVM _ VLANEndpoint 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 la _ EthernetPortAllocationSettingData CIM.
-
-
DeviceNamingEnabled
-
-
Type de données : booléen
-
Type d'accès : Lecture seule
Indique si cette carte Ethernet prend en charge les noms d’appareil.
Il s’agit d’une propriété en lecture seule, mais elle peut être modifiée à l’aide de la méthode ModifyVirtualSystemResources de la classe MSVM _ VirtualSystemManagementService .
Notes
ajouté dans Windows 10 et Windows Server 2016.
-
-
ElementName
-
-
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 la _ SettingData CIM.
-
-
HostResource
-
-
Type de données : tableau de chaînes
-
Type d'accès : Lecture seule
Cette propriété est héritée de CIM _ ResourceAllocationSettingDataet est toujours définie sur null.
-
-
InstanceID
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : clé
Identifie de façon unique une instance de cette classe. Cette propriété est héritée de la _ propriété ManagedElement CIM.
-
-
Limite
-
-
Type de données : UInt64
-
Type d'accès : Lecture seule
Limite supérieure ou quantité maximale de ressources qui seront accordées pour cette allocation. Cette propriété est héritée de la _ ResourceAllocationSettingData CIM.
-
-
MappingBehavior
-
-
Type de données : UInt16
-
Type d'accès : Lecture seule
Spécifie comment cette ressource est mappée aux ressources sous-jacentes. Cette propriété est héritée de la _ ResourceAllocationSettingData CIM.
-
-
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 de réseau local virtuel qui est pris en charge par ce point de terminaison VLAN. Cette propriété est utilisée uniquement lorsque la propriété DesiredVLANEndpointMode est définie sur 1 (autre). Cette propriété doit être définie sur null lorsque la propriété DesiredVLANEndpointMode a une valeur autre que 1. Cette propriété est héritée de la _ EthernetPortAllocationSettingData CIM.
-
-
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 « Other » (0). Cette propriété est héritée de CIM _ ResourceAllocationSettingDataet 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 la _ ResourceAllocationSettingData CIM.
-
-
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 sera allouée lorsque l’allocation aura lieu. Cette propriété est héritée de la _ ResourceAllocationSettingData CIM.
-
-
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 surengagement de ressources, cette valeur est généralement utilisée pour le contrôle d’admission pour empêcher l’acceptation d’une allocation. Cette propriété est héritée de la _ ResourceAllocationSettingData CIM.
-
-
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 la _ ResourceAllocationSettingData CIM.
-
-
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 _ ResourceAllocationSettingDataet est toujours définie sur 10 (carte Ethernet).
-
-
StaticMacAddress
-
-
Type de données : booléen
-
Type d'accès : Lecture seule
Spécifie si l’adresse MAC est statique.
-
-
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 la _ ResourceAllocationSettingData CIM.
-
-
VirtualQuantityUnits
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Spécifie l’unité de mesure pour la propriété VirtualQuantity . La valeur de cette propriété doit être une valeur légale du qualificateur d’unités de programmation, tel que défini dans l’annexe C. 1 de DSP0004 V 2.5 ou version ultérieure. Cette propriété est héritée de la _ ResourceAllocationSettingData CIM.
-
-
VirtualSystemIdentifiers
-
-
Type de données : tableau de chaînes
-
Type d'accès : Lecture seule
-
Qualificateurs : arrayType ("indexé")
Tableau de chaînes des identificateurs de cette ressource présentée au système d’exploitation de l’ordinateur virtuel. Les index et les valeurs par index sont définis par ressource (c’est-à-dire, pour chaque valeur de propriété resourceType énumérée).
-
-
Poids
-
-
Type de données : UInt32
-
Type d'accès : Lecture seule
Priorité relative pour cette allocation par rapport à d’autres allocations à partir du même pool de ressources. Cette propriété est héritée de la _ ResourceAllocationSettingData CIM.
-
Remarques
L’accès à la classe MSVM _ SyntheticEthernetPortSettingData peut être limité par le filtrage UAC. Pour plus d’informations, consultez contrôle de compte d’utilisateur et WMI.
Exemples
Consultez interrogation d’objets de mise en réseau.
Configuration requise
| 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 |
\Virtualisation racine \ v2 |
| MOF |
|
| DLL |
|