Clase Msvm_EmulatedEthernetPort
Representa un adaptador Ethernet emulado. Este adaptador se usa cuando una máquina virtual no es capaz de ejecutar el puerto Ethernet sintético cuando no hay circuitos integrados instalados en el invitado.
Nota:
Esta clase no está disponible para las máquinas virtuales de generación 2.
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_EmulatedEthernetPort : CIM_EthernetPort
{
string InstanceID;
string Caption = "Ethernet Port";
string Description = "Microsoft Emulated Ethernet Port";
string ElementName = "Legacy Network Adapter";
datetime InstallDate;
string Name = "Ethernet Port";
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_EmulatedEthernetPort";
string DeviceID = "Microsoft:GUID\device-specific data";
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 Speed = 1000000000;
uint64 MaxSpeed = 1000000000;
uint64 RequestedSpeed = 1000000000;
uint16 UsageRestriction = 4;
uint16 PortType = 1;
string OtherPortType = "Virtual Ethernet";
string OtherNetworkPortType;
uint16 PortNumber;
uint16 LinkTechnology = 2;
string OtherLinkTechnology;
string PermanentAddress;
string NetworkAddresses[];
boolean FullDuplex = True;
boolean AutoSense = True;
string SupportedMaximumTransmissionUnit = 1500;
uint64 ActiveMaximumTransmissionUnit = 1500;
uint32 MaxDataSize = 1500;
uint16 Capabilities[];
string CapabilityDescriptions[];
uint16 EnabledCapabilities[];
string OtherEnabledCapabilities[];
};
Miembros
La clase Msvm_EmulatedEthernetPort tiene estos tipos de miembros:
Métodos
La clase Msvm_EmulatedEthernetPort 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 emulado. |
| 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_EmulatedEthernetPort tiene estas propiedades.
-
ActiveMaximumTransmissionUnit
-
-
Tipo de datos: uint64
-
Tipo de acceso: solo lectura
Unidad de transmisión máxima (MTU) activa o negociada que se puede admitir. Esta propiedad se hereda de CIM_NetworkPort y siempre se establece en 1500.
-
-
AdditionalAvailability
-
-
Tipo de datos: matriz uint16
-
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 y siempre se establece en 6 ("No aplicable").
-
-
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 y siempre se establece en True.
-
-
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 y siempre se establece en Null.
-
-
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
Funcionalidades del puerto Ethernet. Esta propiedad se hereda de CIM_EthernetPort y no se usa.
-
-
CapabilityDescriptions
-
-
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 características del puerto Ethernet que se indican en la matriz Capabilities . Tenga en cuenta que cada entrada de esta matriz está relacionada con la entrada de la matriz Capabilities que se encuentra en el mismo índice. Esta propiedad se hereda de CIM_EthernetPort y no se usa.
-
-
Caption
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
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 la clase o la subclase usada en la creación de una instancia. Cuando se usa con las demás propiedades clave de esta clase, esta propiedad permite identificar de forma única todas las instancias de esta clase y sus subclases. Esta propiedad se hereda de CIM_LogicalDevice y siempre se establece en "Msvm_EmulatedEthernetPort".
-
-
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 emulado 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 utilizada para asignar un nombre único al dispositivo lógico. Esta propiedad se hereda de CIM_LogicalDevice y siempre se establece en "Datos específicos del dispositivo Microsoft:GUID\".
-
-
ElementName
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
Nombre para mostrar del objeto. Esta propiedad se hereda de CIM_ManagedElement y siempre se establece en "Adaptador de red heredado".
-
-
EnabledCapabilities
-
-
Tipo de datos: matriz uint16
-
Tipo de acceso: solo lectura
Las funcionalidades que se habilitan en la lista de todos los admitidos, que se definen en la matriz Capabilities . Esta propiedad se hereda de CIM_EthernetPort, pero no se usa.
-
-
EnabledDefault
-
-
Tipo de datos: uint16
-
Tipo de acceso: solo lectura
Configuración predeterminada o de inicio de un administrador para el estado habilitado 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. Esta propiedad se hereda de CIM_EnabledLogicalElement y siempre se establece en 5 ("No aplicable").
-
-
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 y 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 y 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 y siempre se establece en True.
-
-
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. Esta propiedad se hereda de CIM_ManagedSystemElement y siempre se establece en 5 ("Ok").
-
-
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 OtherIdentifyingInfo . Cada entrada de esta matriz está relacionada con la entrada de OtherIdentifyingInfo que se encuentra en el mismo índice. Esta propiedad se hereda de CIM_LogicalDevice y no se usa.
-
-
InstallDate
-
-
Tipo de datos: datetime
-
Tipo de acceso: solo lectura
Valor datetime que indica cuándo se instaló el objeto. La falta de un valor no indica que el objeto no 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.
-
-
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 y no se usa.
-
-
LinkTechnology
-
-
Tipo de datos: uint16
-
Tipo de acceso: solo lectura
Tipos de vínculos. Cuando se establece en 1 ("Other"), la propiedad relacionada OtherLinkTechnology contiene una descripción de cadena del tipo de vínculo. Esta propiedad se hereda de CIM_NetworkPort y siempre se establece en 2 ("Ethernet").
-
-
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 se hereda de CIM_LogicalDevice y no se usa.
-
-
MaxSpeed
-
-
Tipo de datos: uint64
-
Tipo de acceso: solo lectura
Ancho de banda máximo del puerto, en bits por segundo. Esta propiedad se hereda de CIM_LogicalPort y siempre se establece en 10000000000.
-
-
Nombre
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
Etiqueta por la que se conoce el objeto. Cuando se subclase, esta propiedad se puede invalidar para que sea una propiedad de clave. Esta propiedad se hereda de CIM_ManagedSystemElement y siempre se establece en "Puerto Ethernet".
-
-
NetworkAddresses
-
-
Tipo de datos: matriz de cadenas
-
Tipo de acceso: solo lectura
Las direcciones MAC Ethernet/802.3, con formato de doce dígitos hexadecimales (por ejemplo, "010203040506"), con cada par que representa uno de los seis octetos de la dirección MAC en orden de bits canónico (el bit de dirección de grupo se encuentra en el bit de orden bajo del primer carácter de la cadena). Esta propiedad se hereda de CIM_EthernetPort y no se usa.
-
-
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 elemento. Esta propiedad se hereda de CIM_ManagedSystemElement y 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 "Other". Esta propiedad se hereda de CIM_EthernetPort y no se usa.
-
-
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 ("Other"). Esta propiedad debe establecerse en Null cuando EnabledState es cualquier valor distinto de 1. Esta propiedad se hereda de CIM_EnabledLogicalElement y no se usa.
-
-
OtherIdentifyingInfo
-
-
Tipo de datos: matriz de cadenas
-
Tipo de acceso: solo lectura
Cualquier dato, además de la información del identificador de dispositivo, que se podría usar para identificar un dispositivo lógico. Por ejemplo, podría usar esta propiedad para contener el nombre para mostrar del sistema operativo para el dispositivo. Esta propiedad se hereda de CIM_LogicalDevice y no se usa.
-
-
OtherLinkTechnology
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
Valor de cadena que describe LinkTechnology cuando se establece en 1 ("Other"). Esta propiedad se hereda de CIM_NetworkPort, pero no se usa.
-
-
OtherNetworkPortType
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
Esta propiedad se hereda de CIM_NetworkPort y se establece en Null.
-
-
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 y siempre se establece en "Virtual Ethernet".
-
-
PermanenteAddress
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
Dirección de red codificada de forma dura en un puerto. Esta dirección 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. Debe dejarse en blanco si no existe ninguna dirección codificada de forma codificada para el adaptador de red. Esta propiedad se hereda de CIM_NetworkPort.
-
-
Númerodepuerto
-
-
Tipo de datos: uint16
-
Tipo de acceso: solo lectura
Los puertos de red a menudo se numeran en relación con un módulo lógico o un elemento de red. Esta propiedad se hereda de CIM_NetworkPort.
Valor Significado - 0
La NIC no se emula. - 1
La NIC se emula. -
-
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_EthernetPort y siempre se establece en 1 ("Other").
-
-
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 y 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 y no se usa.
-
-
PowerOnHours
-
-
Tipo de datos: uint64
-
Tipo de acceso: solo lectura
Número de horas consecutivas que este dispositivo ha estado encendido desde su último ciclo de alimentación. Esta propiedad se hereda de CIM_LogicalDevice y 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
Ancho de banda solicitado del puerto, en bits por segundo. El ancho de banda real se notifica en LogicalPort.Speed. Esta propiedad se hereda de CIM_LogicalPort y siempre se establece en 10000000000.
-
-
RequestedState
-
-
Tipo de datos: uint16
-
Tipo de acceso: solo lectura
El último estado solicitado o deseado para el servicio de administración. Cuando EnabledState se establece en 5 ("No aplicable"), esta propiedad no tiene ningún significado. 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
Ancho de banda actual del puerto, en bits por segundo. Para los puertos que varían en ancho de banda o para aquellos en los que no se puede realizar una estimación precisa, esta propiedad debe contener el ancho de banda nominal. Esta propiedad se hereda de CIM_NetworkPort y siempre se establece en 10000000000.
-
-
Estado
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
Esta propiedad se hereda de CIM_ManagedSystemElement, pero no se usa.
-
-
StatusDescriptions
-
-
Tipo de datos: matriz de cadenas
-
Tipo de acceso: solo lectura
Cadenas que describen los distintos valores de matriz OperationalStatus . Las entradas de esta matriz se correlacionan con las del mismo índice de matriz en OperationalStatus. Esta propiedad se hereda de CIM_ManagedSystemElement y siempre se establece en "Ok".
-
-
StatusInfo
-
-
Tipo de datos: uint16
-
Tipo de acceso: solo lectura
Estado del dispositivo lógico. Esta propiedad se hereda de CIM_LogicalDevice y no se usa.
-
-
SupportedMaximumTransmissionUnit
-
-
Tipo de datos: cadena
-
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 y siempre se establece en 1500.
-
-
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
Identificador de la máquina virtual en formato GUID . Esta propiedad se hereda de CIM_LogicalDevice.
-
-
TimeOfLastStateChange
-
-
Tipo de datos: datetime
-
Tipo de acceso: solo lectura
Fecha u hora en que enabledState del elemento cambió por última vez. Si el estado del elemento no ha cambiado y esta propiedad se rellena, debe establecerse en un valor de intervalo 0. Si se solicitó un cambio de estado, pero se rechazó o aún no se procesó, la propiedad no se debe actualizar. Esta propiedad se hereda de CIM_EnabledLogicalElement y no se usa.
-
-
TotalPowerOnHours
-
-
Tipo de datos: uint16
-
Tipo de acceso: solo lectura
Número total de horas que este dispositivo se ha encendido. Esta propiedad se hereda de CIM_LogicalDevice y 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. Si no hay ninguna restricción en el uso del puerto, el valor debe establecerse en 4 ("Sin restricciones"). Esta propiedad se hereda de CIM_LogicalPort y siempre se establece en 4 ("No restringido").
-
Comentarios
El acceso a la clase Msvm_EmulatedEthernetPort 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 |
|
| Archivo DLL |
|
Consulte también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de