Clase Msvm_ExternalEthernetPort

Representa un puerto Ethernet externo (adaptador de red). Estos tipos de puertos Ethernet proporcionan a las máquinas virtuales acceso a la red externa.

La siguiente sintaxis es código de Formato de objeto administrado (MOF) simplificado e incluye todas las propiedades heredadas.

Sintaxis

[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;
};

Miembros

La clase Msvm_ExternalEthernetPort tiene estos tipos de miembros:

• Métodos
• Propiedades

Métodos

La clase Msvm_ExternalEthernetPort tiene estos métodos.

Método	Descripción
EnableDevice	No se admite este método.
OnlineDevice	No se admite este método.
QuiesceDevice	No se admite este método.
RequestStateChange	Solicita un cambio de estado.
Restablecer	Restablece el dispositivo virtual.
RestoreProperties	No se admite este método.
SaveProperties	No se admite este método.
SetPowerState	No se admite este método.

Propiedades

La clase Msvm_ExternalEthernetPort tiene estas propiedades.

ActiveMaximumTransmissionUnit

Tipo de datos: uint64

Tipo de acceso: solo lectura

Calificadores: unidades ("bytes")

Unidad de transmisión máxima (MTU) activa o negociada que se puede admitir, en bytes. Esta propiedad se hereda de CIM_NetworkPort.

AdditionalAvailability

Tipo de datos: matriz de cadenas

Tipo de acceso: solo lectura

Cualquier disponibilidad y estado adicionales del dispositivo, más allá de lo especificado en la propiedad Availability . Esta propiedad se hereda de CIM_LogicalDevice, pero no se usa.

AutoSense

Tipo de datos: booleano

Tipo de acceso: solo lectura

Indica si el puerto de red es capaz de determinar automáticamente la velocidad u otras características de comunicaciones del medio de red conectado. Esta propiedad se hereda de CIM_NetworkPort.

Disponibilidad

Tipo de datos: uint16

Tipo de acceso: solo lectura

La disponibilidad principal y el estado del dispositivo. Esta propiedad se hereda de CIM_LogicalDevice, pero no se usa.

AvailableRequestedStates

Tipo de datos: matriz uint16

Tipo de acceso: solo lectura

Indica los valores posibles para el parámetro RequestedState del método RequestStateChange utilizado para iniciar un cambio de estado. Los valores enumerados serán un subconjunto de los valores contenidos en la propiedad RequestedStatesSupported de la instancia asociada de CIM_EnabledLogicalElementCapabilities, donde los valores seleccionados son una función del estado actual de la CIM_EnabledLogicalElement. Esta propiedad puede ser distinta de Null si una implementación puede anunciar el conjunto de valores posibles como una función del estado actual. Esta propiedad será Null si una implementación no puede determinar el conjunto de valores posibles como una función del estado actual.

Esta propiedad se hereda de CIM_EnabledLogicalElement.

Habilitado (2)

Deshabilitado (3)

Apagar (4)

Sin conexión (6)

Prueba (7)

Aplazar (8)

Modo inactivo (9)

Reinicio (10)

Restablecimiento (11)

DMTF Reservado (.. )

Capabilities

Tipo de datos: matriz uint16

Tipo de acceso: solo lectura

Matriz que especifica las funciones del puerto. Esta propiedad se hereda de CIM_EthernetPort.

Desconocido (0)

Otros (1)

AlertOnLan (2)

WakeOnLan (3)

Conmutación por error (4)

LoadBalancing (5)

CapabilityDescriptions

Tipo de datos: matriz de cadenas

Tipo de acceso: solo lectura

Matriz de cadenas de forma libre que proporciona explicaciones más detalladas sobre las características de puerto contenidas en la matriz Capabilities . Cada entrada de esta matriz está relacionada con la entrada correspondiente de la matriz Capabilities que se encuentra en el mismo índice. Esta propiedad se hereda de CIM_EthernetPort.

Caption

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: MaxLen (64)

Descripción breve del objeto. Esta propiedad se hereda de CIM_ManagedElement y siempre se establece en "Puerto Ethernet".

CommunicationStatus

Tipo de datos: uint16

Tipo de acceso: solo lectura

Indica la capacidad de la instrumentación para comunicarse con el elemento administrado subyacente. Un valor Null indica que esta propiedad no está implementada. Esta propiedad se hereda de CIM_ManagedSystemElement.

CreationClassName

Tipo de datos: cadena

Tipo de acceso: solo lectura

Nombre de clase de creación del sistema de ámbito. Esta propiedad se hereda de CIM_LogicalDevice y siempre se establece en "Msvm_ExternalEthernetPort".

Descripción

Tipo de datos: cadena

Tipo de acceso: solo lectura

Descripción del objeto. Esta propiedad se hereda de CIM_ManagedElement y siempre se establece en "Puerto Ethernet externo de Microsoft".

DetailedStatus

Tipo de datos: uint16

Tipo de acceso: solo lectura

Complementa la propiedad PrimaryStatus con detalles de estado adicionales. Un valor Null indica que esta propiedad no está implementada. Esta propiedad se hereda de CIM_ManagedSystemElement.

Deviceid

Tipo de datos: cadena

Tipo de acceso: solo lectura

Una dirección u otra información de identificación para asignar un nombre único al dispositivo lógico. Esta propiedad se hereda de CIM_LogicalDevice.

ElementName

Tipo de datos: cadena

Tipo de acceso: solo lectura

Nombre para mostrar del objeto. Esta propiedad se hereda de CIM_ManagedElement.

EnabledCapabilities

Tipo de datos: matriz uint16

Tipo de acceso: solo lectura

Especifica qué funcionalidades están habilitadas en la lista de todas las funcionalidades admitidas en la matriz Capabilities . Esta propiedad se hereda de CIM_EthernetPort.

Desconocido (0)

Otros (1)

AlertOnLan (2)

WakeOnLan (3)

Conmutación por error (4)

LoadBalancing (5)

EnabledDefault

Tipo de datos: uint16

Tipo de acceso: solo lectura

Configuración predeterminada o de inicio de un administrador para la propiedad EnabledState de un elemento. Esta propiedad se hereda de CIM_EnabledLogicalElement y siempre se establece en 2 (Habilitado).

EnabledState

Tipo de datos: uint16

Tipo de acceso: solo lectura

Estados habilitados y deshabilitados de un elemento. También puede indicar las transiciones entre estos estados solicitados. Por ejemplo, el apagado (4) y el inicio (10) son estados transitorios entre habilitado y deshabilitado. Esta propiedad se hereda de CIM_EnabledLogicalElement.

Valor	Significado
Unknown 0
Otros 1
Enabled 2	El elemento es o podría estar ejecutando comandos, procesará los comandos en cola y pondrá en cola nuevas solicitudes.
Deshabilitada 3	El elemento no ejecutará comandos y quitará las nuevas solicitudes.
Cerrando 4	El elemento está en proceso de ir a un estado Deshabilitado.
No aplicable 5	El elemento no admite la habilitación o deshabilitación.
Habilitado pero sin conexión 6	El elemento podría estar completando comandos y quitará las nuevas solicitudes.
En prueba 7	El elemento está en un estado de prueba.
Diferido 8	El elemento puede estar completando comandos, pero pondrá en cola las nuevas solicitudes.
Modo de inactividad 9	El elemento está habilitado, pero en modo restringido. El comportamiento del elemento es similar al estado Enabled, pero solo procesa un conjunto restringido de comandos. Todas las demás solicitudes se ponen en cola.
Starting (iniciándose) 10	El elemento está en proceso de ir a un estado Habilitado. Las nuevas solicitudes se ponen en cola.
DmTF reservado 11 32767	Reservado.
Proveedor reservado 32768 65535	Reservado.

ErrorCleared

Tipo de datos: booleano

Tipo de acceso: solo lectura

Indica si el error notificado en LastErrorCode ahora está borrado. Esta propiedad se hereda de CIM_LogicalDevice, pero no se usa.

ErrorDescription

Tipo de datos: cadena

Tipo de acceso: solo lectura

Cadena que proporciona más información sobre el error registrado en LastErrorCode e información sobre las acciones correctivas que se pueden realizar. Esta propiedad se hereda de CIM_LogicalDevice, pero no se usa.

FullDuplex

Tipo de datos: booleano

Tipo de acceso: solo lectura

Indica si el puerto funciona en modo dúplex completo. Esta propiedad se hereda de CIM_NetworkPort.

HealthState

Tipo de datos: uint16

Tipo de acceso: solo lectura

Estado actual del elemento. Este atributo expresa el estado de este elemento, pero no necesariamente el de sus subcomponentes. Los valores posibles son de 0 a 30, donde 5 significa que el elemento es completamente correcto y 30 significa que el elemento no funciona completamente. Esta propiedad se hereda de CIM_ManagedSystemElement y siempre se establece en 5 (Correcto).

IdentifyingDescriptions

Tipo de datos: matriz de cadenas

Tipo de acceso: solo lectura

Matriz de cadenas de forma libre que proporcionan explicaciones y detalles detrás de las entradas de la matriz de propiedades OtherIdentifyingInfo . Esta propiedad se hereda de CIM_LogicalDevice, pero no se usa.

InstallDate

Tipo de datos: datetime

Tipo de acceso: solo lectura

Fecha y hora en que se instaló el objeto. Esta propiedad no necesita un valor para indicar que el objeto está instalado. Esta propiedad se hereda de CIM_ManagedSystemElement.

InstanceID

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: Clave

Identifica de forma única una instancia de esta clase. Esta propiedad se hereda de CIM_ManagedElement.

IsBound

Tipo de datos: booleano

Tipo de acceso: solo lectura

Si esta propiedad es True, este puerto Ethernet se puede conectar a los conmutadores y, por tanto, puede proporcionar conectividad a una máquina virtual. Si esta propiedad es False, la arquitectura de red de la máquina virtual no usa este puerto Ethernet.

LastErrorCode

Tipo de datos: uint32

Tipo de acceso: solo lectura

El último código de error notificado por el dispositivo lógico. Esta propiedad se hereda de CIM_LogicalDevice, pero no se usa.

LinkTechnology

Tipo de datos: uint16

Tipo de acceso: solo lectura

Especifica el tipo de tecnología de vínculo para el puerto. Cuando se establece en 1 (Otros), la propiedad OtherLinkTechnology contiene una descripción de cadena del tipo de vínculo. Esta propiedad se hereda de CIM_NetworkPort.

Desconocido (0)

Otros (1)

Ethernet (2)

IB (3)

FC (4)

FDDI (5)

ATM (6)

Token Ring (7)

Frame Relay (8)

Infrarrojo (9)

BlueTooth (10)

LAN inalámbrica (11)

MaxDataSize

Tipo de datos: uint32

Tipo de acceso: solo lectura

Tamaño máximo del campo INFO (no MAC) que se recibirá o transmitirá. Esta propiedad se hereda de CIM_EthernetPort y siempre se establece en 1500.

MaxQuiesceTime

Tipo de datos: uint64

Tipo de acceso: solo lectura

Esta propiedad está en desuso. Esta propiedad se hereda de CIM_LogicalDevice, pero no se usa.

MaxSpeed

Tipo de datos: uint64

Tipo de acceso: solo lectura

Calificadores: unidades ("bits por segundo")

Ancho de banda máximo del puerto, en bits por segundo. Esta propiedad se hereda de CIM_LogicalPort.

Nombre

Tipo de datos: cadena

Tipo de acceso: solo lectura

Etiqueta por la que se conoce el objeto. Esta propiedad se hereda de CIM_ManagedSystemElement.

NetworkAddresses

Tipo de datos: matriz de cadenas

Tipo de acceso: solo lectura

Calificadores: MaxLen ( 64 )

Matriz de cadenas que contienen las direcciones MAC del puerto. Esta propiedad se hereda de CIM_NetworkPort.

OperatingStatus

Tipo de datos: uint16

Tipo de acceso: solo lectura

Proporciona información de estado actual para la condición operativa del elemento y se puede usar para proporcionar más detalles con respecto al valor de la propiedad EnabledState . Un valor Null indica que esta propiedad no está implementada. Esta propiedad se hereda de CIM_ManagedSystemElement.

OperationalStatus

Tipo de datos: matriz uint16

Tipo de acceso: solo lectura

Estados actuales del objeto . Esta propiedad se hereda de CIM_ManagedSystemElement y cada elemento de matriz siempre se establece en 2 (OK).

OtherEnabledCapabilities

Tipo de datos: matriz de cadenas

Tipo de acceso: solo lectura

Matriz de cadenas de forma libre que proporciona explicaciones más detalladas para cualquiera de las funcionalidades habilitadas que se especifican como 1 (Otros). Esta propiedad se hereda de CIM_EthernetPort.

OtherEnabledState

Tipo de datos: cadena

Tipo de acceso: solo lectura

Cadena que describe el estado habilitado o deshabilitado del elemento cuando la propiedad EnabledState está establecida en 1 (Otro). Esta propiedad debe establecerse en Null cuando EnabledState es cualquier valor distinto de 1. Esta propiedad se hereda de CIM_EnabledLogicalElement.

OtherIdentifyingInfo

Tipo de datos: matriz de cadenas

Tipo de acceso: solo lectura

Cualquier dato adicional, más allá de la información del identificador de dispositivo, que se podría usar para identificar un dispositivo lógico. Esta propiedad se hereda de CIM_LogicalDevice, pero no se usa.

OtherLinkTechnology

Tipo de datos: cadena

Tipo de acceso: solo lectura

Valor de cadena que describe LinkTechnology cuando se establece en 1 (Otro). Esta propiedad se hereda de CIM_NetworkPort.

OtherNetworkPortType

Tipo de datos: cadena

Tipo de acceso: solo lectura

El uso de esta propiedad está en desuso en lugar de la propiedad PortType . Esta propiedad se hereda de CIM_NetworkPort.

OtherPortType

Tipo de datos: cadena

Tipo de acceso: solo lectura

El tipo de módulo, cuando PortType se establece en 1 ("Other"). Esta propiedad se hereda de CIM_LogicalPort.

PermanenteAddress

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: MaxLen (64)

Dirección de red codificada de forma dura en un puerto. Esta dirección codificada de forma predeterminada se puede cambiar mediante una actualización de firmware o una configuración de software. Cuando se realiza este cambio, el campo debe actualizarse al mismo tiempo. Esta propiedad debe ser Null si no existe ninguna dirección codificada de forma dura para el adaptador de red. Esta propiedad se hereda de CIM_NetworkPort.

Númerodepuerto

Tipo de datos: uint16

Tipo de acceso: solo lectura

Número del puerto. Esta propiedad se hereda de CIM_NetworkPort.

PortType

Tipo de datos: uint16

Tipo de acceso: solo lectura

Modo específico que está habilitado actualmente para el puerto. Cuando se establece en 1 ("Other"), la propiedad relacionada OtherPortType contiene una descripción de cadena del tipo de puerto. Esta propiedad se hereda de CIM_LogicalPort.

Desconocido (0)

Otros (1)

//50 Cobre 10BaseT (50)

10-100BaseT (51)

100BaseT (52)

1000BaseT (53)

2500BaseT (54)

10GBaseT (55)

10GBase-CX4 (56)

//100 Fibra 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)

Proveedor reservado (16000 65535)

PowerManagementCapabilities

Tipo de datos: matriz uint16

Tipo de acceso: solo lectura

Las funcionalidades de administración de energía del dispositivo. Esta propiedad se hereda de CIM_LogicalDevice, pero no se usa.

PowerManagementSupported

Tipo de datos: booleano

Tipo de acceso: solo lectura

Indica si el dispositivo se puede administrar con energía. Esta propiedad se hereda de CIM_LogicalDevice, pero no se usa.

PowerOnHours

Tipo de datos: uint64

Tipo de acceso: solo lectura

Número de horas consecutivas que este dispositivo se ha encendido desde su último ciclo de alimentación. Esta propiedad se hereda de CIM_LogicalDevice, pero no se usa.

PrimaryStatus

Tipo de datos: uint16

Tipo de acceso: solo lectura

Proporciona información de estado de alto nivel. Esta propiedad debe usarse junto con la propiedad DetailedStatus para proporcionar información de estado de mantenimiento detallada y de alto nivel para el elemento y sus subcomponentes. Un valor Null indica que esta propiedad no está implementada. Esta propiedad se hereda de CIM_ManagedSystemElement.

RequestedSpeed

Tipo de datos: uint64

Tipo de acceso: solo lectura

Calificadores: unidades ("Bits por segundo")

Ancho de banda solicitado del puerto en bits por segundo. El ancho de banda real se notifica en la propiedad Speed . Esta propiedad se hereda de CIM_LogicalPort.

RequestedState

Tipo de datos: uint16

Tipo de acceso: solo lectura

El último estado solicitado o deseado para el elemento. Esta propiedad se hereda de CIM_EnabledLogicalElement y siempre se establece en 12 (no aplicable).

Velocidad

Tipo de datos: uint64

Tipo de acceso: solo lectura

Calificadores: unidades ("bits por segundo")

Ancho de banda del puerto, en bits por segundo. Esta propiedad se hereda de CIM_LogicalPort.

Estado

Tipo de datos: cadena

Tipo de acceso: solo lectura

Estado actual del objeto. Esta propiedad se hereda de CIM_ManagedSystemElement.

"Ok"

VALE

Error

Degradado

Desconocido

Error previo

Comenzando

Parar

Servicio

Tensionado

No autorrecuperación

Sin contacto

Comm perdido

StatusDescriptions

Tipo de datos: matriz de cadenas

Tipo de acceso: solo lectura

Cadenas que describen los distintos valores de matriz OperationalStatus . Esta propiedad se hereda de CIM_ManagedSystemElement y cada elemento de matriz siempre se establece en "Ok".

StatusInfo

Tipo de datos: uint16

Tipo de acceso: solo lectura

Estado actual del dispositivo lógico. Esta propiedad se hereda de CIM_LogicalDevice, pero no se usa.

SupportedMaximumTransmissionUnit

Tipo de datos: uint64

Tipo de acceso: solo lectura

Calificadores: unidades ("bytes")

Unidad de transmisión máxima (MTU) que se puede admitir, en bytes. Esta propiedad se hereda de CIM_NetworkPort.

SystemCreationClassName

Tipo de datos: cadena

Tipo de acceso: solo lectura

Nombre de clase de creación del sistema de ámbito. Esta propiedad se hereda de CIM_LogicalDevice y siempre se establece en "Msvm_ComputerSystem".

SystemName

Tipo de datos: cadena

Tipo de acceso: solo lectura

Nombre del sistema de ámbito. Esta propiedad se hereda de CIM_LogicalDevice.

TimeOfLastStateChange

Tipo de datos: datetime

Tipo de acceso: solo lectura

Fecha u hora en que el estado habilitado del elemento cambió por última vez. Esta propiedad se hereda de CIM_EnabledLogicalElement y siempre se establece en Null.

TotalPowerOnHours

Tipo de datos: uint64

Tipo de acceso: solo lectura

Número total de horas que este dispositivo se ha encendido. Esta propiedad se hereda de CIM_LogicalDevice, pero no se usa.

TransitioningToState

Tipo de datos: uint16

Tipo de acceso: solo lectura

Indica el estado de destino al que se está realizando la transición de la instancia. Esta propiedad se hereda de CIM_EnabledLogicalElement, pero no se usa.

UsageRestriction

Tipo de datos: uint16

Tipo de acceso: solo lectura

En algunas circunstancias, un puerto lógico puede ser identificable como un puerto front-end o back-end. Un ejemplo de esta situación sería una matriz de almacenamiento que podría tener puertos back-end para comunicarse con unidades de disco y puertos front-end para comunicarse con hosts. Si no hay ninguna restricción en el uso del puerto, el valor debe establecerse en "No restringido". Esta propiedad se hereda de CIM_LogicalPort.

Desconocido (0)

Solo front-end (2)

Solo back-end (3)

Sin restricciones (4)

Comentarios

El acceso a la clase Msvm_ExternalEthernetPort puede estar restringido por el filtrado de UAC. Para obtener más información, vea Control de cuentas de usuario y WMI.

Ejemplos

Consulte Consulta de objetos de red.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 [solo aplicaciones de escritorio]
Espacio de nombres	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
Archivo DLL	Vmms.exe

Consulte también

CIM_EthernetPort

CIM_EthernetPort