Msvm_SyntheticEthernetPort, classe
Représente un adaptateur Ethernet synthétique. Cette carte est la carte réseau préférée en raison de ses performances et parce que les modifications apportées à celle-ci peuvent prendre effet immédiatement, pendant qu’elle est en cours d’utilisation (configurabilité à chaud).
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_SyntheticEthernetPort : CIM_EthernetPort
{
string InstanceID;
string Caption;
string Description;
string ElementName;
datetime InstallDate;
string Name;
uint16 OperationalStatus[] = 2;
string StatusDescriptions[];
string Status;
uint16 HealthState;
uint16 CommunicationStatus;
uint16 DetailedStatus;
uint16 OperatingStatus;
uint16 PrimaryStatus;
uint16 EnabledState;
string OtherEnabledState;
uint16 RequestedState;
uint16 EnabledDefault;
datetime TimeOfLastStateChange;
uint16 AvailableRequestedStates[];
uint16 TransitioningToState;
string SystemCreationClassName;
string SystemName;
string CreationClassName;
string DeviceID;
boolean PowerManagementSupported;
uint16 PowerManagementCapabilities[];
uint16 Availability;
uint16 StatusInfo;
uint32 LastErrorCode;
string ErrorDescription;
boolean ErrorCleared;
string OtherIdentifyingInfo[];
uint64 PowerOnHours;
uint64 TotalPowerOnHours;
string IdentifyingDescriptions[];
uint16 AdditionalAvailability[] = 6;
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[];
};
Membres
La classe Msvm_SyntheticEthernetPort a les types de membres suivants :
Méthodes
La classe Msvm_SyntheticEthernetPort 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. |
Réinitialiser | Réinitialise l’appareil. |
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_SyntheticEthernetPort 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. Cette propriété est héritée de CIM_NetworkPort.
-
-
Disponibilité supplémentaire
-
-
Type de données : uint16 array
-
Type d'accès : Lecture seule
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, et elle est toujours définie sur 6 (Non applicable).
-
-
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.
-
-
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
Fonctionnalités du port Ethernet. Par exemple, l’appareil peut prendre en charge AlertOnLan, WakeOnLan, Équilibrage de charge ou Basculement automatique. Si des fonctionnalités de basculement ou d’équilibrage de charge sont répertoriées, un SpareGroup (basculement) ou Un ExtraCapacityGroup (équilibrage de charge) doit également être défini pour décrire complètement la fonctionnalité. Cette propriété est héritée de CIM_EthernetPort et n’est pas utilisée.
-
-
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 toutes les fonctionnalités EthernetPort indiquées dans le tableau de propriétés Capabilities . Notez que chaque entrée de ce tableau est liée à l’entrée dans le tableau de propriétés Capabilities qui se trouve au même index. Cette propriété est héritée de CIM_EthernetPort et n’est pas utilisée.
-
-
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.
-
-
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 dans la création d’un instance. 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 CIM_ManagedElement.
-
-
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 utilisées pour 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
Fonctionnalités activées dans la liste de toutes les fonctionnalités prises en charge, définies dans le tableau de propriétés Capabilities . Cette propriété est héritée de CIM_EthernetPort, mais elle n’est pas utilisée.
-
-
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 CIM_EnabledLogicalElement.
-
-
EnabledState
-
-
Type de données : uint16
-
Type d'accès : Lecture seule
États activés et désactivés de cet élément. Cette propriété est héritée de CIM_EnabledLogicalElement.
-
-
ErrorCleared
-
-
Type de données : booléen
-
Type d'accès : Lecture seule
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
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. 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 derrière les entrées dans le tableau OtherIdentifyingInfo . 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
Date à laquelle le port Ethernet a été ajouté à la machine virtuelle. 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.
-
-
LastErrorCode
-
-
Type de données : uint32
-
Type d'accès : Lecture seule
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
Énumération des types de liens. Lorsqu’elle est définie sur 1 (Autre), la propriété OtherLinkTechnology associée contient une description de chaîne du type de lien. Cette propriété est héritée de CIM_NetworkPort.
-
Ethernet (2)
-
-
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.
-
-
MaxQuiesceTime
-
-
Type de données : uint64
-
Type d'accès : Lecture seule
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
Nom complet de l’objet. 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
Adresses MAC Ethernet/802.3 au format de douze chiffres hexadécimaux (par exemple, « 010203040506 »), chaque paire représentant l’un des six octets de l’adresse MAC dans l’ordre canonique (le bit d’adresse du groupe se trouve dans le bit d’ordre inférieur du premier caractère de la chaîne). Cette propriété est héritée de CIM_EthernetPort et n’est pas utilisée.
-
-
OperatingStatus
-
-
Type de données : uint16
-
Type d'accès : Lecture seule
Fournit des informations de status actuelles sur 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 : tableau uint16
-
Type d'accès : Lecture seule
Status actuelle de l’élément. Cette propriété est héritée de CIM_ManagedSystemElement et est toujours définie 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 comme « Autre ». Cette propriété est héritée de CIM_EthernetPort et n’est pas utilisée.
-
-
OtherEnabledState
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
État activé ou désactivé de l’élément lorsque la propriété EnabledState a la valeur 1 (Autre). 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, en plus des informations d’ID d’appareil, qui peuvent être utilisées pour identifier un appareil logique. 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 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
Cette propriété est héritée de CIM_NetworkPort et est définie sur Null.
-
-
OtherPortType
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Type de module, lorsque PortType est défini sur 1 (Autre). Cette propriété est héritée de CIM_LogicalPort.
-
-
PermanentAddress
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Adresse réseau codée en dur dans le 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. La propriété PermanentAddress 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 CIM_NetworkPort.
-
-
PortNumber
-
-
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 CIM_NetworkPort.
-
-
Porttype
-
-
Type de données : uint16
-
Type d'accès : Lecture seule
Mode spécifique actuellement activé pour le port. Quand la valeur est 1 (Other), la propriété associée OtherPortType contient une description de chaîne du type de port. Cette propriété est héritée de CIM_EthernetPort.
-
-
PowerManagementCapabilities
-
-
Type de données : tableau uint16
-
Type d'accès : Lecture seule
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
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
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é de haut niveau et 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 le service de gestion. Cette propriété est héritée de CIM_EnabledLogicalElement.
-
-
Vitesse
-
-
Type de données : uint64
-
Type d'accès : Lecture seule
-
Qualificateurs : unités (« 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 CIM_NetworkPort.
-
-
État
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Status actuelle de l’élément. Cette propriété est héritée de CIM_ManagedSystemElement.
-
-
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.
-
-
StatusInfo
-
-
Type de données : uint16
-
Type d'accès : Lecture seule
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. 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.
-
-
SystemName
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Nom NetBIOS du système informatique d’hébergement. Cette propriété contient l’ID de machine virtuelle au format GUID . 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.
-
-
TotalPowerOnHours
-
-
Type de données : uint64
-
Type d'accès : Lecture seule
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.
-
-
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. S’il n’existe aucune restriction sur l’utilisation du port, la valeur doit être définie sur 4 (non restreint). Cette propriété est héritée de CIM_LogicalPort.
-
Notes
L’accès à la classe Msvm_SyntheticEthernetPort 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.
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 |
|
DLL |
|