Msvm_ExternalEthernetPort, classe

Représente un port Ethernet externe (carte réseau). Ces types de ports Ethernet permettent aux machines virtuelles d’accéder au réseau externe.

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_ExternalEthernetPort : CIM_EthernetPort
{
  string   InstanceID;
  string   Caption = "Ethernet Port";
  string   Description = "Microsoft External Ethernet Port";
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[] = 2;
  string   StatusDescriptions[] = "OK";
  string   Status = "OK";
  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_ExternalEthernetPort";
  string   DeviceID;
  boolean  PowerManagementSupported;
  uint16   PowerManagementCapabilities[];
  uint16   Availability;
  uint16   StatusInfo;
  uint32   LastErrorCode;
  string   ErrorDescription;
  boolean  ErrorCleared;
  string   OtherIdentifyingInfo[];
  uint64   PowerOnHours;
  uint64   TotalPowerOnHours;
  string   IdentifyingDescriptions[];
  string   AdditionalAvailability[];
  uint64   MaxQuiesceTime;
  uint64   Speed;
  uint64   MaxSpeed;
  uint64   RequestedSpeed;
  uint16   UsageRestriction;
  uint16   PortType;
  string   OtherPortType;
  string   OtherNetworkPortType;
  uint16   PortNumber;
  uint16   LinkTechnology;
  string   OtherLinkTechnology;
  string   PermanentAddress;
  string   NetworkAddresses[];
  boolean  FullDuplex;
  boolean  AutoSense;
  uint64   SupportedMaximumTransmissionUnit;
  uint64   ActiveMaximumTransmissionUnit;
  uint32   MaxDataSize;
  uint16   Capabilities[];
  string   CapabilityDescriptions[];
  uint16   EnabledCapabilities[];
  string   OtherEnabledCapabilities[];
  boolean  IsBound;
};

Membres

La classe Msvm_ExternalEthernetPort a les types de membres suivants :

• Méthodes
• Propriétés

Méthodes

La classe Msvm_ExternalEthernetPort a ces méthodes.

Propriétés

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

ActiveMaximumTransmissionUnit

Type de données : uint64

Type d'accès : Lecture seule

Qualificateurs : unités (« octets »)

Unité de transmission maximale (MTU) active ou négociée qui peut être prise en charge, en octets. Cette propriété est héritée de CIM_NetworkPort.

Disponibilité supplémentaire

Type de données : tableau de chaînes

Type d'accès : Lecture seule

Toute disponibilité et status supplémentaires de l’appareil, au-delà de celle spécifiée dans la propriété Availability. Cette propriété est héritée de CIM_LogicalDevice, mais elle n’est pas utilisée.

Autosense

Type de données : booléen

Type d'accès : Lecture seule

Indique si le port réseau est capable de déterminer automatiquement la vitesse ou d’autres caractéristiques de communication du média réseau attaché. Cette propriété est héritée de CIM_NetworkPort.

Disponibilité

Type de données : uint16

Type d'accès : Lecture seule

Disponibilité principale et status de l’appareil. Cette propriété est héritée de CIM_LogicalDevice, mais elle n’est pas utilisée.

AvailableRequestedStates

Type de données : uint16 array

Type d'accès : Lecture seule

Indique les valeurs possibles pour le paramètre RequestedState de la méthode RequestStateChange utilisée pour lancer un changement d’état. Les valeurs répertoriées seront un sous-ensemble des valeurs contenues dans la propriété RequestedStatesSupported du instance de CIM_EnabledLogicalElementCapabilities associé, où les valeurs sélectionnées sont une fonction de l’état actuel de la CIM_EnabledLogicalElement. Cette propriété peut être non Null si une implémentation est en mesure de publier l’ensemble de valeurs possibles en fonction de l’état actuel. Cette propriété a la valeur Null si une implémentation ne peut pas déterminer l’ensemble de valeurs possibles en fonction de l’état actuel.

Cette propriété est héritée de CIM_EnabledLogicalElement.

Activé (2)

Désactivé (3)

Arrêter (4)

Hors connexion (6)

Test (7)

Report (8)

Quiesce (9)

Redémarrage (10)

Réinitialiser (11)

DMTF Réservé (.. )

Capabilities

Type de données : uint16 array

Type d'accès : Lecture seule

Tableau qui spécifie les fonctionnalités du port. Cette propriété est héritée de CIM_EthernetPort.

Inconnu (0)

Autre (1)

AlertOnLan (2)

WakeOnLan (3)

FailOver (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 pour les fonctionnalités de port contenues dans le tableau Fonctionnalités . Chaque entrée de ce tableau est liée à l’entrée correspondante dans le tableau Fonctionnalités qui se trouve au même index. Cette propriété est héritée de CIM_EthernetPort.

Caption

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (64)

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

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 de création du système d’étendue. Cette propriété est héritée de CIM_LogicalDevice et elle est toujours définie sur « Msvm_ExternalEthernetPort ».

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 « Port Ethernet externe Microsoft ».

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.

DeviceID

Type de données : chaîne

Type d'accès : Lecture seule

Adresse ou autres informations d’identification permettant de nommer de manière unique l’appareil logique. Cette propriété est héritée de CIM_LogicalDevice.

ElementName

Type de données : chaîne

Type d'accès : Lecture seule

Nom d’affichage de l’objet. Cette propriété est héritée de CIM_ManagedElement.

EnabledCapabilities

Type de données : uint16 array

Type d'accès : Lecture seule

Spécifie les fonctionnalités activées dans la liste de toutes les fonctionnalités prises en charge dans le tableau Fonctionnalités . Cette propriété est héritée de CIM_EthernetPort.

Inconnu (0)

Autre (1)

AlertOnLan (2)

WakeOnLan (3)

FailOver (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 la propriété EnabledState d’un élément. Cette propriété est héritée de CIM_EnabledLogicalElement, et elle est toujours définie sur 2 (Activé).

EnabledState

Type de données : uint16

Type d'accès : Lecture seule

États activés et désactivés d’un élément. Il peut également indiquer les transitions entre ces états demandés. Par exemple, l’arrêt (4) et le démarrage (10) sont des états temporaires entre activé et désactivé. Cette propriété est héritée de CIM_EnabledLogicalElement.

Valeur	Signification
Unknown 0
Autres 1
Activé 2	L’élément est ou peut exécuter des commandes, traitera toutes les commandes mises en file d’attente et met en file d’attente les nouvelles demandes.
Désactivé 3	L’élément n’exécute pas de commandes et supprime les nouvelles demandes.
Fermeture 4	L’élément est en train d’atteindre un état Désactivé.
Non applicable 5	L’élément ne prend pas en charge l’activation ou la désactivation.
Activé mais hors connexion 6	L’élément termine peut-être des commandes, et il supprime toutes les nouvelles demandes.
En test 7	L’élément est dans un état de test.
Différé 8	L’élément termine peut-être des commandes, mais il met en file d’attente toutes les nouvelles demandes.
Mettre en suspens 9	L’élément est activé, mais en mode restreint. Le comportement de l’élément est similaire à l’état Activé, mais il ne traite qu’un ensemble restreint de commandes. Toutes les autres demandes sont mises en file d’attente.
Démarrage en cours 10	L’élément est en train d’atteindre un état Activé. Les nouvelles demandes sont mises en file d’attente.
DMTF réservé 11 32767	Réservé.
Fournisseur réservé 32768 65535	Réservé.

ErrorCleared

Type de données : booléen

Type d'accès : Lecture seule

Indique si l’erreur signalée dans LastErrorCode est maintenant effacée. Cette propriété est héritée de CIM_LogicalDevice, mais elle n’est pas utilisée.

ErrorDescription

Type de données : chaîne

Type d'accès : Lecture seule

Chaîne qui fournit plus d’informations sur l’erreur enregistrée dans LastErrorCode et des informations sur les actions correctives qui peuvent être effectuées. Cette propriété est héritée de CIM_LogicalDevice, mais elle 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 CIM_NetworkPort.

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. Les valeurs possibles sont de 0 à 30, où 5 signifie que l’élément est entièrement sain et 30 signifie que l’élément est complètement non fonctionnel. Cette propriété est héritée de CIM_ManagedSystemElement, et elle est toujours définie sur 5 (OK).

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 derrière les entrées dans le tableau de propriétés OtherIdentifyingInfo . Cette propriété est héritée de CIM_LogicalDevice, mais elle n’est pas utilisée.

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.

IsBound

Type de données : booléen

Type d'accès : Lecture seule

Si cette propriété a la valeur True, ce port Ethernet peut être connecté aux commutateurs et ainsi fournir une connectivité à une machine virtuelle. Si cette propriété a la valeur False, ce port Ethernet n’est pas utilisé par l’architecture réseau de machine virtuelle.

LastErrorCode

Type de données : uint32

Type d'accès : Lecture seule

Dernier code d’erreur signalé par l’appareil logique. Cette propriété est héritée de CIM_LogicalDevice, mais elle n’est pas utilisée.

LinkTechnology

Type de données : uint16

Type d'accès : Lecture seule

Spécifie le type de technologie de liaison pour le port. Lorsqu’elle est définie sur 1 (Autre), la propriété OtherLinkTechnology contient une description sous forme de chaîne du type de lien. Cette propriété est héritée de CIM_NetworkPort.

Inconnu (0)

Autre (1)

Ethernet (2)

IB (3)

FC (4)

FDDI (5)

ATM (6)

Token Ring (7)

Relais de trame (8)

Infrarouge (9)

BlueTooth (10)

Réseau local sans fil (11)

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 CIM_EthernetPort, et elle est toujours définie sur 1500.

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, mais elle n’est pas utilisée.

Maxspeed

Type de données : uint64

Type d'accès : Lecture seule

Qualificateurs : unités (« Bits par seconde »)

Bande passante maximale du port, en bits par seconde. Cette propriété est héritée de CIM_LogicalPort.

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.

NetworkAddresses

Type de données : tableau de chaînes

Type d'accès : Lecture seule

Qualificateurs : MaxLen ( 64 )

Tableau de chaînes qui contiennent les adresses MAC du port. Cette propriété est héritée de CIM_NetworkPort.

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.

OperationalStatus

Type de données : uint16 array

Type d'accès : Lecture seule

État actuel de l’objet. Cette propriété est héritée de CIM_ManagedSystemElement, et chaque élément de tableau est toujours défini sur 2 (OK).

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 pour toutes les fonctionnalités activées spécifiées sous la forme 1 (Autre). Cette propriété est héritée de CIM_EthernetPort.

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 avoir la valeur Null lorsque EnabledState a une valeur autre que 1. Cette propriété est héritée de CIM_EnabledLogicalElement.

OtherIdentifyingInfo

Type de données : tableau de chaînes

Type d'accès : Lecture seule

Toutes les données supplémentaires, au-delà des informations d’ID d’appareil, qui pourraient être utilisées pour identifier un appareil logique. Cette propriété est héritée de CIM_LogicalDevice, mais elle 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 LinkTechnology lorsqu’elle est définie sur 1 (Autre). Cette propriété est héritée de CIM_NetworkPort.

OtherNetworkPortType

Type de données : chaîne

Type d'accès : Lecture seule

L’utilisation de cette propriété est déconseillée au lieu de la propriété PortType . Cette propriété est héritée de CIM_NetworkPort.

OtherPortType

Type de données : chaîne

Type d'accès : Lecture seule

Type de module, lorsque PortType a la valeur 1 (« Autre »). Cette propriété est héritée de CIM_LogicalPort.

Adresse permanente

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (64)

Adresse réseau codée en dur dans un port. Cette adresse codée en dur 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. Cette propriété doit avoir la valeur Null si aucune adresse codée en dur n’existe pour la carte réseau. Cette propriété est héritée de CIM_NetworkPort.

PortNumber

Type de données : uint16

Type d'accès : Lecture seule

Numéro de port. Cette propriété est héritée de CIM_NetworkPort.

Porttype

Type de données : uint16

Type d'accès : Lecture seule

Mode spécifique actuellement activé pour le port. Lorsqu’elle est définie sur 1 (« Autre »), la propriété OtherPortType associée contient une description de chaîne du type de port. Cette propriété est héritée de CIM_LogicalPort.

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-EW (111)

Fournisseur réservé (16000 65535)

PowerManagementCapabilities

Type de données : uint16 array

Type d'accès : Lecture seule

Fonctionnalités de gestion de l’alimentation de l’appareil. Cette propriété est héritée de CIM_LogicalDevice, mais elle 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é sur l’alimentation. Cette propriété est héritée de CIM_LogicalDevice, mais elle n’est pas utilisée.

PowerOnHours

Type de données : uint64

Type d'accès : Lecture seule

Nombre d’heures consécutives pendant lesquelles cet appareil a été mis sous tension depuis son dernier cycle d’alimentation. Cette propriété est héritée de CIM_LogicalDevice, mais elle n’est pas utilisée.

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 des informations d’intégrité détaillées status 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

Qualificateurs : unités (« Bits par seconde »)

Bande passante demandée du port en bits par seconde. La bande passante réelle est signalée dans la propriété Speed . Cette propriété est héritée de CIM_LogicalPort.

RequestedState

Type de données : uint16

Type d'accès : Lecture seule

Dernier état demandé ou souhaité pour l’élément. Cette propriété est héritée de CIM_EnabledLogicalElement et est toujours définie sur 12 (Non applicable).

Vitesse

Type de données : uint64

Type d'accès : Lecture seule

Qualificateurs : unités (« Bits par seconde »)

Bande passante du port, en bits par seconde. Cette propriété est héritée de CIM_LogicalPort.

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

« OK »

D'ACCORD

Erreur

Dégradé

Inconnu

Échec de la préversion

Démarrage

Arrêt

Service

Stressé

Non-récupération

Aucun contact

Lost Comm

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, et chaque élément de tableau est toujours défini sur « OK ».

StatusInfo

Type de données : uint16

Type d'accès : Lecture seule

État actuel de l’appareil logique. Cette propriété est héritée de CIM_LogicalDevice, mais elle n’est pas utilisée.

SupportedMaximumTransmissionUnit

Type de données : uint64

Type d'accès : Lecture seule

Qualificateurs : unités (« octets »)

Unité de transmission maximale (MTU) qui peut être prise en charge, en octets. Cette propriété est héritée de CIM_NetworkPort.

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 et est toujours définie sur « Msvm_ComputerSystem ».

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 l’état activé de l’élément. Cette propriété est héritée de CIM_EnabledLogicalElement et est toujours définie sur Null.

TotalPowerOnHours

Type de données : uint64

Type d'accès : Lecture seule

Nombre total d’heures pendant lesquelles cet appareil a été alimenté. Cette propriété est héritée de CIM_LogicalDevice, mais elle n’est pas utilisée.

TransitioningToState

Type de données : uint16

Type d'accès : Lecture seule

Indique l’état cible vers lequel le instance effectue la transition. 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 en tant que port frontal ou principal. Un exemple de cette situation est un tableau de stockage qui peut avoir des ports back-end pour communiquer avec les lecteurs de disque et des ports frontaux pour communiquer avec les hôtes. S’il n’existe aucune restriction sur l’utilisation du port, la valeur doit être définie sur « Non restreint ». Cette propriété est héritée de CIM_LogicalPort.

Inconnu (0)

Front-end uniquement (2)

Back-end uniquement (3)

Non restreint (4)

Notes

L’accès à la classe Msvm_ExternalEthernetPort peut être limité par le filtrage des UAC. 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

Voir aussi

CIM_EthernetPort

CIM_EthernetPort