MSVM _ InternalEthernetPort, classe
Représente un port Ethernet interne (carte réseau). Ce type de port Ethernet permet aux ordinateurs virtuels d’accéder au serveur de virtualisation exécutant le logiciel de mise en réseau. Les cartes réseau internes permettent au trafic réseau des ordinateurs virtuels d’être acheminés ou filtrés avant de quitter le système physique.
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_InternalEthernetPort : CIM_EthernetPort
{
string InstanceID;
string Caption = "Ethernet Port";
string Description = "Microsoft Internal Ethernet Port";
string ElementName;
datetime InstallDate;
string Name;
uint16 OperationalStatus[] = 2;
string StatusDescriptions[] = { "OK" };
string Status;
uint16 HealthState = 5;
uint16 CommunicationStatus;
uint16 DetailedStatus;
uint16 OperatingStatus;
uint16 PrimaryStatus;
uint16 EnabledState = 5;
string OtherEnabledState;
uint16 RequestedState = 12;
uint16 EnabledDefault = 2;
datetime TimeOfLastStateChange;
uint16 AvailableRequestedStates[];
uint16 TransitioningToState;
string SystemCreationClassName = "Msvm_ComputerSystem";
string SystemName;
string CreationClassName = "Msvm_InternalEthernetPort";
string DeviceID;
boolean PowerManagementSupported;
uint16 PowerManagementCapabilities[];
uint16 Availability;
uint16 StatusInfo;
uint32 LastErrorCode;
string ErrorDescription;
boolean ErrorCleared;
string OtherIdentifyingInfo[];
uint64 PowerOnHours;
uint16 TotalPowerOnHours;
string IdentifyingDescriptions[];
uint16 AdditionalAvailability[] = 6;
uint64 MaxQuiesceTime;
uint64 MaxSpeed = 1000000000;
uint64 RequestedSpeed = 1000000000;
uint16 UsageRestriction = 4;
string OtherPortType;
uint64 Speed;
string OtherNetworkPortType;
uint16 PortNumber;
uint16 LinkTechnology = 2;
string OtherLinkTechnology;
string PermanentAddress;
boolean FullDuplex = True;
boolean AutoSense = True;
uint64 SupportedMaximumTransmissionUnit = 1500;
uint64 ActiveMaximumTransmissionUnit = 1500;
uint16 PortType;
string NetworkAddresses[];
uint32 MaxDataSize = 1500;
uint16 Capabilities[];
string CapabilityDescriptions[];
uint16 EnabledCapabilities[];
string OtherEnabledCapabilities[];
};
Membres
La classe MSVM _ InternalEthernetPort possède les types de membres suivants :
Méthodes
La classe MSVM _ InternalEthernetPort possède ces méthodes.
| Méthode | Description |
|---|---|
| EnableDevice | Cette méthode n'est pas prise en charge. |
| OnlineDevice | Cette méthode n'est pas prise en charge. |
| QuiesceDevice | Cette méthode n'est pas prise en charge. |
| RequestStateChange | Demande un changement d’État. |
| Initialisation | Réinitialise l’appareil virtuel. |
| RestoreProperties | Cette méthode n'est pas prise en charge. |
| SaveProperties | Cette méthode n'est pas prise en charge. |
| SetPowerState | Cette méthode n'est pas prise en charge. |
Propriétés
La classe MSVM _ InternalEthernetPort possède les propriétés suivantes.
-
ActiveMaximumTransmissionUnit
-
-
Type de données : UInt64
-
Type d'accès : Lecture seule
Unité de transmission maximale (MTU) active ou négociée qui peut être prise en charge. Cette propriété est héritée de la _ NetworkPort CIM.
-
-
AdditionalAvailability
-
-
Type de données : tableau UInt16
-
Type d'accès : Lecture seule
Disponibilité et état supplémentaires de l’appareil, au-delà de celui spécifié dans la propriété Availability . Cette propriété est héritée de CIM _ LogicalDevice.
-
-
Détection automatique
-
-
Type de données : booléen
-
Type d'accès : Lecture seule
Indique si le port réseau peut déterminer automatiquement la vitesse ou d’autres caractéristiques de communication du support réseau attaché. Cette propriété est héritée de la _ NetworkPort CIM.
-
-
Disponibilité
-
-
Type de données : UInt16
-
Type d'accès : Lecture seule
Disponibilité et état principaux de l’appareil. Cette propriété est héritée de CIM _ LogicalDevice et n’est pas utilisée.
-
-
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 utilisée pour initier un changement d’État. Les valeurs répertoriées sont un sous-ensemble des valeurs contenues dans la propriété RequestedStatesSupported de l’instance associée de la _ EnabledLogicalElementCapabilities CIM, où les valeurs sélectionnées sont une fonction de l’état actuel de l’objet _ EnabledLogicalElement CIM . Cette propriété peut être non null si une implémentation est en mesure de publier l’ensemble de valeurs possibles en tant que fonction de l’état actuel. Cette propriété a la valeur null si une implémentation ne peut pas déterminer le jeu de valeurs possibles en tant que fonction de l’état actuel.
Cette propriété est héritée de CIM _ EnabledLogicalElement, mais elle n’est pas utilisée.
-
-
Capabilities
-
-
Type de données : tableau UInt16
-
Type d'accès : Lecture seule
Fonctionnalités du port Ethernet. Si les fonctionnalités de basculement ou d’équilibrage de charge sont répertoriées, un _ SpareGroup CIM (basculement) ou un _ ExtraCapacityGroup CIM (équilibrage de charge) doit également être défini pour décrire complètement la fonctionnalité. Cette propriété est héritée de la _ EthernetPort CIM.
-
Inconnu (0)
-
Autre (1)
-
AlertOnLan (2)
-
Wakeonlan (3)
-
Basculement (4)
-
LoadBalancing (5)
-
-
CapabilityDescriptions
-
-
Type de données : tableau de chaînes
-
Type d'accès : Lecture seule
Tableau de chaînes de forme libre qui fournit des explications plus détaillées sur les fonctionnalités de port Ethernet indiquées dans le tableau de fonctionnalités . Notez que chaque entrée de ce tableau est liée à l’entrée dans le tableau de fonctionnalités qui se trouve dans le même index. Cette propriété est héritée de la _ EthernetPort 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.
-
-
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.
-
-
CreationClassName
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Nom de la classe ou de la sous-classe utilisée lors de la création d’une instance. Quand elle est utilisée avec les autres propriétés de clé de cette classe, cette propriété autorise l’identification unique de toutes les instances de cette classe et de ses sous-classes. Cette propriété est héritée de CIM _ LogicalDevice.
-
-
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.
-
-
DetailedStatus
-
-
Type de données : UInt16
-
Type d'accès : Lecture seule
Complète la propriété PrimaryStatus avec des détails d’État 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.
-
-
DeviceID
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Une adresse ou d’autres informations d’identification utilisées pour nommer de façon unique l’unité logique. Cette propriété est héritée de CIM _ LogicalDeviceet est définie sur « Microsoft :GUID \ Device-Specific Data».
-
-
ElementName
-
-
Type de données : chaîne
-
Type d’accès : lecture/écriture
Nom complet de l’objet. Cette propriété permet à chaque instance de définir un nom complet en plus de ses propriétés de clé, données d’identité et informations de description. Cette propriété est héritée de CIM _ propriété ManagedElement et est générée en fonction de la carte réseau présente dans l’hôte.
-
-
EnabledCapabilities
-
-
Type de données : tableau UInt16
-
Type d'accès : Lecture seule
Spécifie les fonctionnalités qui sont activées dans la liste de tous les types pris en charge, qui sont définis dans le tableau de fonctionnalités . Cette propriété est héritée de la _ EthernetPort CIM.
-
Inconnu (0)
-
Autre (1)
-
AlertOnLan (2)
-
Wakeonlan (3)
-
Basculement (4)
-
LoadBalancing (5)
-
-
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 la _ EnabledLogicalElement CIM.
-
-
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é est héritée de la _ EnabledLogicalElement CIM.
-
-
ErrorCleared
-
-
Type de données : booléen
-
Type d'accès : Lecture seule
Indique si l’erreur signalée dans la propriété LastErrorCode est maintenant désactivée. Cette propriété est héritée de CIM _ LogicalDevice et n’est pas utilisée.
-
-
ErrorDescription
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Chaîne qui fournit des informations supplémentaires sur l’erreur enregistrée dans la propriété LastErrorCode et des informations sur toutes les actions correctives qui peuvent être effectuées. Cette propriété est héritée de la propriété _ LogicalDevice CIM et n’est pas utilisée.
-
-
FullDuplex
-
-
Type de données : booléen
-
Type d'accès : Lecture seule
Indique si le port fonctionne en mode duplex intégral. Cette propriété est héritée de la _ NetworkPort CIM.
-
-
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. Cette propriété est héritée de CIM _ ManagedSystemElement.
-
-
IdentifyingDescriptions
-
-
Type de données : tableau de chaînes
-
Type d'accès : Lecture seule
Tableau de chaînes de forme libre qui fournissent des explications et des détails sur les entrées du tableau de propriétés OtherIdentifyingInfo . Chaque entrée de ce tableau est liée à l’entrée dans le tableau de propriétés OtherIdentifyingInfo situé dans le même index. Cette propriété est héritée de CIM _ LogicalDevice et n’est pas utilisée.
-
-
InstallDate
-
-
Type de données : DateTime
-
Type d'accès : Lecture seule
Valeur DateTime qui indique le moment où l’objet a été installé. L’absence de valeur n’indique pas que l’objet n’est pas 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 façon unique une instance de cette classe. Cette propriété est héritée de la _ propriété ManagedElement CIM.
-
-
LastErrorCode
-
-
Type de données : UInt32
-
Type d'accès : Lecture seule
Dernier code d’erreur signalé par l’unité logique. Cette propriété est héritée de CIM _ LogicalDevice et n’est pas utilisée.
-
-
LinkTechnology
-
-
Type de données : UInt16
-
Type d'accès : Lecture seule
Types de liens. Si la valeur 1 (autre) est définie, la propriété associée OtherLinkTechnology contient une description de chaîne du type de lien. Cette propriété est héritée de la _ NetworkPort CIM.
Valeur Signification - 2
Ethernet -
-
MaxDataSize
-
-
Type de données : UInt32
-
Type d'accès : Lecture seule
Taille maximale du champ INFO (non-MAC) qui sera reçu ou transmis. Cette propriété est héritée de la _ EthernetPort CIM.
-
-
MaxQuiesceTime
-
-
Type de données : UInt64
-
Type d'accès : Lecture seule
Cette propriété est dépréciée. Cette propriété est héritée de CIM _ LogicalDevice et n’est pas utilisée.
-
-
MaxSpeed
-
-
Type de données : UInt64
-
Type d'accès : Lecture seule
Bande passante maximale du port, en bits par seconde. Cette propriété est héritée de la _ LogicalPort CIM.
-
-
Nom
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Étiquette par laquelle l’objet est connu. Lorsqu’elle est sous-classée, cette propriété peut être substituée pour être une propriété de clé. Cette propriété est héritée de CIM _ ManagedSystemElement.
-
-
NetworkAddresses
-
-
Type de données : tableau de chaînes
-
Type d'accès : Lecture seule
Les adresses MAC Ethernet/802.3 au format 12 chiffres hexadécimaux (par exemple, « 010203040506 »), chaque paire représentant l’un des six octets de l’adresse MAC dans l’ordre des bits canoniques (le bit d’adresse de groupe se trouve dans le bit de poids faible du premier caractère de la chaîne). Cette propriété est héritée de la _ EthernetPort CIM.
-
-
OperatingStatus
-
-
Type de données : UInt16
-
Type d'accès : Lecture seule
Fournit des informations sur l’état actuel de la condition opérationnelle de l’élément et peut être utilisé 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.
-
-
OperationalStatus
-
-
Type de données : tableau UInt16
-
Type d'accès : Lecture seule
États actuels de l’élément. Cette propriété est héritée de CIM _ ManagedSystemElement.
-
-
OtherEnabledCapabilities
-
-
Type de données : tableau de chaînes
-
Type d'accès : Lecture seule
Tableau de chaînes de forme libre qui fournit des explications plus détaillées sur les fonctionnalités activées spécifiées comme 1 (autre). Cette propriété est héritée de la _ EthernetPort CIM.
-
-
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 être définie sur null lorsque la propriété EnabledState a une valeur autre que 1. Cette propriété est héritée de la _ EnabledLogicalElement CIM.
-
-
OtherIdentifyingInfo
-
-
Type de données : tableau de chaînes
-
Type d'accès : Lecture seule
Toutes les données, en plus des informations d’ID de l’appareil, qui peuvent être utilisées pour identifier un périphérique logique. Par exemple, vous pouvez utiliser cette propriété pour stocker le nom complet du système d’exploitation de l’appareil. Cette propriété est héritée de CIM _ LogicalDevice et n’est pas utilisée.
-
-
OtherLinkTechnology
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Valeur de chaîne qui décrit la propriété LinkTechnology lorsqu’elle a la valeur 1 (autre). Cette propriété est héritée de la _ NetworkPort CIM.
-
-
OtherNetworkPortType
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Cette propriété est déconseillée. Utilisez la propriété portType . Cette propriété est héritée de la _ NetworkPort CIM.
Description déconseillée : type de module, lorsque la propriété portType a la valeur 1 (other).
-
-
OtherPortType
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Type de module, lorsque la propriété portType a la valeur 1 (other). Cette propriété est héritée de la _ LogicalPort CIM .
-
-
PermanentAddress
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Adresse réseau qui est codée en dur dans un port. Cette adresse peut être modifiée à l’aide d’une mise à niveau du microprogramme ou d’une configuration logicielle. Lorsque cette modification est apportée, le champ doit être mis à jour en même temps. Elle doit être laissée vide si aucune adresse codée en dur n’existe pour la carte réseau. Cette propriété est héritée de la _ NetworkPort CIM.
-
-
Numéroport
-
-
Type de données : UInt16
-
Type d'accès : Lecture seule
Les ports réseau sont souvent numérotés par rapport à un module logique ou à un élément réseau. Cette valeur est 1 pour les cartes réseau émulées, 0 pour toutes les autres. Cette propriété est héritée de la _ NetworkPort CIM.
-
-
PortType
-
-
Type de données : UInt16
-
Type d'accès : Lecture seule
Mode spécifique actuellement activé pour le port. Si la valeur 1 (autre) est définie, la propriété associée OtherPortType contient une description de chaîne du type de port. Cette propriété est héritée de la _ EthernetPort CIM.
-
Inconnu (0)
-
Autre (1)
-
//50 cuivre 10BaseT (50)
-
10-100BaseT (51)
-
100BaseT (52)
-
1000BaseT (53)
-
2500BaseT (54)
-
10GBaseT (55)
-
10GBASE-CX4 (56)
-
//100 fibre 100Base-FX (100)
-
100Base-SX (101)
-
1000Base-SX (102)
-
1000Base-LX (103)
-
1000Base-CX (104)
-
10GBase-SR (105)
-
10GBase-SW (106)
-
10GBASE-LX4 (107)
-
10GBASE-LR (108)
-
10GBase-LW (109)
-
10GBASE-ER (110)
-
10GBASE-SEM (111)
-
Fournisseur réservé (16000 65535)
-
-
PowerManagementCapabilities
-
-
Type de données : tableau UInt16
-
Type d'accès : Lecture seule
Les fonctionnalités de gestion de l’alimentation de l’appareil. Cette propriété est héritée de CIM _ LogicalDevice et n’est pas utilisée.
-
-
PowerManagementSupported
-
-
Type de données : booléen
-
Type d'accès : Lecture seule
Indique si l’appareil peut être géré par l’alimentation. Cette propriété est héritée de CIM _ LogicalDevice et n’est pas utilisée.
-
-
PowerOnHours
-
-
Type de données : UInt64
-
Type d'accès : Lecture seule
Nombre d’heures consécutives pendant lesquelles ce périphérique a été alimenté depuis son dernier cycle d’alimentation. Cette propriété est héritée de CIM _ LogicalDevice et n’est pas utilisée.
-
-
PrimaryStatus
-
-
Type de données : UInt16
-
Type d'accès : Lecture seule
Fournit des informations d’état de haut niveau. Cette propriété doit être utilisée conjointement avec la propriété DetailedStatus pour fournir des informations d’état d’intégrité de haut niveau et détaillées pour l’élément et 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.
-
-
RequestedSpeed
-
-
Type de données : UInt64
-
Type d'accès : Lecture seule
Bande passante demandée du port, en bits par seconde. La bande passante réelle est indiquée dans la propriété Speed . Cette propriété est héritée de la _ LogicalPort CIM.
-
-
RequestedState
-
-
Type de données : UInt16
-
Type d'accès : Lecture seule
Dernier État demandé ou souhaité pour le service de gestion. Lorsque la propriété EnabledState a la valeur 5 (non applicable), cette propriété n’a aucune signification. Cette propriété est héritée de la _ EnabledLogicalElement CIM.
-
-
Temps
-
-
Type de données : UInt64
-
Type d'accès : Lecture seule
-
Qualificateurs : override, Units ("bits par seconde")
Bande passante actuelle du port en bits par seconde. Pour les ports qui varient en bande passante ou pour ceux pour lesquels aucune estimation précise ne peut être effectuée, cette propriété doit contenir la bande passante nominale. Cette propriété est héritée de la _ NetworkPort CIM.
-
-
État
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
État actuel 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 de tableau OperationalStatus . Les entrées de ce tableau sont corrélées avec celles situées au même index de tableau dans OperationalStatus. Cette propriété est héritée de CIM _ ManagedSystemElement.
-
-
StatusInfo
-
-
Type de données : UInt16
-
Type d'accès : Lecture seule
État de l’unité logique. Cette propriété est héritée de CIM _ LogicalDevice et n’est pas utilisée.
-
-
SupportedMaximumTransmissionUnit
-
-
Type de données : UInt64
-
Type d'accès : Lecture seule
Unité de transmission maximale (MTU) qui peut être prise en charge. Cette propriété est héritée de la _ NetworkPort CIM.
-
-
SystemCreationClassName
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Nom de la classe de création du système d’étendue. Cette propriété est héritée de CIM _ LogicalDevice, mais elle n’est pas prise en charge
-
-
SystemName
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Nom du système d’étendue. Cette propriété est héritée de CIM _ LogicalDevice.
-
-
TimeOfLastStateChange
-
-
Type de données : DateTime
-
Type d'accès : Lecture seule
Date ou heure de la dernière modification de la propriété EnabledState de l’élément. Si l’état de l’élément n’a pas été modifié et que cette propriété est remplie, elle doit être définie sur une valeur d’intervalle 0. Si une modification d’État a été demandée, mais rejetée ou n’a pas encore été traitée, la propriété ne doit pas être mise à jour. Cette propriété est héritée de CIM _ EnabledLogicalElement et n’est pas utilisée.
-
-
TotalPowerOnHours
-
-
Type de données : UInt16
-
Type d'accès : Lecture seule
Nombre total d’heures d’alimentation de cet appareil. Cette propriété est héritée de CIM _ LogicalDevice et n’est pas utilisée.
-
-
TransitioningToState
-
-
Type de données : UInt16
-
Type d'accès : Lecture seule
Indique l’État cible de la transition de l’instance. Cette propriété est héritée de CIM _ EnabledLogicalElement, mais elle n’est pas utilisée.
-
-
UsageRestriction
-
-
Type de données : UInt16
-
Type d'accès : Lecture seule
Dans certains cas, un port logique peut être identifiable comme un port frontal ou back end. Cette propriété est héritée de la _ LogicalPort CIM.
Valeur Signification - 4
Non restreint -
Remarques
L’accès à la classe MSVM _ InternalEthernetPort 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 |
|