MSVM _ EthernetSwitchPort, classe

Représente un port sur le commutateur.

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_EthernetSwitchPort : CIM_EthernetPort
{
  string   InstanceID;
  string   Caption = "Ethernet Switch Port";
  string   Description = "Microsoft Virtual Ethernet Switch Port";
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[] = 2;
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState = 2;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName = "Msvm_VirtualEthernetSwitch";
  string   SystemName;
  string   CreationClassName = "Msvm_EthernetSwitchPort";
  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[];
  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[];
  uint32   VMQOffloadUsage;
  uint32   IOVOffloadUsage;
};

Membres

La classe MSVM _ EthernetSwitchPort possède les types de membres suivants :

Méthodes

La classe MSVM _ EthernetSwitchPort 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 _ EthernetSwitchPort possède les propriétés suivantes.

ActiveMaximumTransmissionUnit

Type de données : UInt64

Type d'accès : Lecture seule

Qualificateurs : Units ("bytes")

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 la _ NetworkPort CIM.

AdditionalAvailability

Type de données : tableau UInt16

Type d'accès : Lecture seule

Disponibilité et état supplémentaires de l’appareil. Cette propriété est héritée de CIM _ LogicalDevice, mais elle n’est pas utilisée.

Détection automatique

Type de données : booléen

Type d'accès : Lecture seule

Indique si le port 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, mais elle 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 du _ 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 la _ EnabledLogicalElement CIM.

Activé (2)

Désactivé (3)

Arrêter (4)

Hors connexion (6)

Test (7)

Différer (8)

Suspension (9)

Redémarrer (10)

Réinitialiser (11)

DMTF réservé (.. )

Capabilities

Type de données : tableau UInt16

Type d'accès : Lecture seule

Tableau qui spécifie les fonctionnalités du port. 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 contenues dans le tableau de fonctionnalités . Chaque entrée de ce tableau est liée à l’entrée correspondante 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 classe CIM _ propriété ManagedElement et elle est toujours définie sur « port commuté 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 _ LogicalDeviceet est toujours définie sur « MSVM _ EthernetSwitchPort ».

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 CIMet est toujours définie sur « port de commutateur Ethernet virtuel Microsoft ».

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 pour nommer de façon unique l’unité 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 complet de l’objet. Cette propriété est héritée de la _ propriété ManagedElement CIM.

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 toutes les fonctionnalités prises en charge 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 la propriété EnabledState d’un élément. Cette propriété est héritée de CIM _ EnabledLogicalElementet 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. Cette propriété est héritée de la _ EnabledLogicalElement CIMet est l’une des valeurs suivantes.

Valeur Signification
Activé
2
L’élément est en cours d’exécution.
Désactivé
3
L’élément est désactivé.

ErrorCleared

Type de données : booléen

Type d'accès : Lecture seule

Indique si l’erreur signalée dans LastErrorCode est maintenant désactivé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 des informations supplémentaires 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 la _ NetworkPort CIM.

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 _ ManagedSystemElementet 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 sur les entrées du 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 façon unique une instance de cette classe. Cette propriété est héritée de la _ propriété ManagedElement CIM.

IOVOffloadUsage

Type de données : UInt32

Type d'accès : Lecture seule

Utilisation du déchargement de la virtualisation d’e/s en cours sur ce port. L’utilisation correspond à la quantité de ressources IOV en cours d’utilisation sur le port.

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, 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 lien pour le port. Lorsque la valeur 1 (autre) est définie, la propriété OtherLinkTechnology contient une description de chaîne du type de lien. Cette propriété est héritée de la _ NetworkPort CIM.

Inconnu (0)

Autre (1)

Ethernet (2)

IB (3)

FC (4)

FDDI (5)

ATM (6)

Token Ring (7)

Relais de trames (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 _ EthernetPortet 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 la _ LogicalPort CIM.

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 contient les adresses MAC du port. Cette propriété est héritée de la _ NetworkPort 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’objet. Cette propriété est héritée de CIM _ ManagedSystemElement, et chaque élément de tableau a toujours la valeur 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 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 CIM _ EnabledLogicalElementet est toujours définie sur null.

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 peuvent être utilisées pour identifier un périphérique 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’il a la valeur 1, (other). Cette propriété est héritée de la _ NetworkPort CIM.

OtherNetworkPortType

Type de données : chaîne

Type d'accès : Lecture seule

L’utilisation de cette propriété est déconseillée à la place de la propriété portType . Cette propriété est héritée de la _ NetworkPort CIM.

OtherPortType

Type de données : chaîne

Type d'accès : Lecture seule

Décrit le type de module, lorsque 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

Qualificateurs : MaxLen (64)

Adresse réseau qui est 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 s’il n’existe aucune adresse codée en dur 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

Le numéro de port. 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é OtherPortType associée contient une description de chaîne du type de port. Cette propriété est héritée de la _ LogicalPort 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, 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é par 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 de mise sous tension de cet appareil 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 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 : écriture seule

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

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 l’élément. Cette propriété est héritée de la _ EnabledLogicalElement CIMet est toujours définie sur 12 (non applicable).

Temps

Type de données : UInt64

Type d'accès : Lecture seule

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

La bande passante du port, en bits par seconde. Cette propriété est héritée de la _ LogicalPort 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 . Cette propriété est héritée de CIM _ ManagedSystemElement.

StatusInfo

Type de données : UInt16

Type d'accès : Lecture seule

État actuel de l’unité 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 : Units ("bytes")

Unité de transmission maximale (MTU) qui peut être prise en charge, en octets. 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 _ LogicalDeviceet est toujours définie sur « MSVM _ VirtualEthernetSwitch ».

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 _ EnabledLogicalElementet est toujours définie sur null.

TotalPowerOnHours

Type de données : UInt64

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, mais elle 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. C’est le cas, par exemple, d’un groupe de stockage qui peut avoir back end ports pour communiquer avec les lecteurs de disque et les 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 4 (non limité). Cette propriété est héritée de la _ LogicalPort CIM.

Inconnu (0)

Frontal uniquement (2)

Serveur principal uniquement (3)

Non restreint (4)

VMQOffloadUsage

Type de données : UInt32

Type d'accès : Lecture seule

La file d’attente d’ordinateurs virtuels actuelle déchargement de l’utilisation sur ce port. L’utilisation correspond à la quantité de ressources d’ordinateurs virtuels en cours d’utilisation sur le port.

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
WindowsVirtualization. v2. mof
DLL
Vmms.exe