Compartir a través de

MSFT_NetTransportConnection clase

  • Artículo

Representa la conexión de transporte para el proveedor WMI v2 de TCP/IP de Microsoft.

La sintaxis siguiente se simplifica desde el código de Formato de objeto administrado (MOF) e incluye todas las propiedades heredadas.

Sintaxis

[UMLPackagePath("CIM::Network::Pipes"), ClassVersion("1.0.0"), dynamic, provider("nettcpip"), AMENDMENT]
class MSFT_NetTransportConnection : CIM_NetworkPipe
{
  string   Caption;
  string   Description;
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[];
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  string   OtherEnabledState;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   TransitioningToState = 12;
  uint16   AvailableRequestedStates[];
  string   InstanceID;
  uint16   EnabledState;
  uint16   RequestedState = 5;
  uint16   Directionality;
  uint16   AggregationBehavior;
  string   LocalAddress;
  uint16   LocalPort;
};

Miembros

La clase MSFT_NetTransportConnection tiene estos tipos de miembros:

Métodos

La clase MSFT_NetTransportConnection tiene estos métodos.

Método Descripción
RequestStateChange Solicita que el estado del elemento se cambie al valor especificado en el parámetro RequestedState. Cuando se produce el cambio de estado solicitado, el estado habilitado y el estado solicitado del elemento serán los mismos. Invocar el método RequestChangeState varias veces podría provocar que las solicitudes anteriores se sobrescriban o se pierdan. Si se devuelve 0, la tarea se completó correctamente y no se requería el uso de CIM_ConcreteJob. Si se devuelve 4096 (0x1000), la tarea tardará algún tiempo en completarse, CIM_ConcreteJob se creará y se devolverá su referencia en el parámetro de salida Job. Cualquier otro código devuelto indica una condición de error.
Este método se hereda de CIM_EnabledLogicalElement.

Propiedades

La clase MSFT_NetTransportConnection tiene estas propiedades.

AggregationBehavior

Tipo de datos: uint16

Tipo de acceso: solo lectura

Indica si la canalización se compone de canalizaciones de nivel inferior y, si es así, cómo se agregan estas canalizaciones de nivel inferior (en paralelo o en secuencia). Las instancias específicas de NetworkPipe que se combinan se describen mediante la asociación NetworkPipeComposition.

Esta propiedad se hereda de CIM_NetworkPipe.

desconocido (0)

no Lower-Level de composición (2)

combinado en paralelo (3)

combinado en secuencia (4)

AvailableRequestedStates

Tipo de datos: matriz de uint16

Tipo de acceso: solo lectura

Calificadores: ModelCorrespondence ("CIM_EnabledLogicalElement.RequestStateChange", "CIM_EnabledLogicalElementCapabilities.RequestedStatesSupported")

AvailableRequestedStates indica los valores posibles para el parámetro RequestedState del método RequestStateChange, que se usa 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 del 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)

test (7)

aplazar (8)

quiesce (9)

reinicio (10)

restablecer (11)

reservado de DMTF (12 65535)

de título de

Tipo de datos: de cadena de

Tipo de acceso: solo lectura

Calificadores: MaxLen (64)

Contiene una breve descripción textual del objeto.

Esta propiedad se hereda de CIM_ManagedElement.

CommunicationStatus

Tipo de datos: uint16

Tipo de acceso: solo lectura

Indica la capacidad de la instrumentación para comunicarse con este elemento. Un valor NULL indica que la instrumentación no admite esta propiedad.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Valores Significado
desconocido
0
 Indica que la instrumentación no puede informar sobre la propiedad communicationStatus de en este momento.
no disponible
1
 Indica que la instrumentación es capaz de notificar esta propiedad, pero intencionadamente no para este elemento.
comunicación correcta
2
 Indica solo que la comunicación se establece con el elemento .
de comunicación perdida
3
 Indica que el elemento se ha contactado en el pasado, pero actualmente no es accesible.
sin contacto
4
 Indica que la instrumentación tiene información de contacto para este elemento, pero nunca ha podido comunicarse con él.
reservada de DMTF
5 32767
 Reservado.
proveedor reservado
32768 = valor
Reservado.

descripción

Tipo de datos: de cadena de

Tipo de acceso: solo lectura

Proporciona una descripción textual del objeto .

Esta propiedad se hereda de CIM_ManagedElement.

DetailedStatus

Tipo de datos: uint16

Tipo de acceso: solo lectura

Calificadores: modelCorrespondence ("CIM_EnabledLogicalElement.PrimaryStatus", "CIM_ManagedSystemElement.HealthState")

Indica detalles de estado adicionales que complementan la propiedad PrimaryStatus. Un valor de NULL indica que la instrumentación no admite esta propiedad.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Valores Significado
no disponible
0
 Indica que la instrumentación es capaz de notificar esta propiedad, pero intencionadamente no la notifica para este elemento.
no hay información adicional
1
 Indica que no es necesario agregar ningún detalle a la propiedad primaryStatus de, por ejemplo, cuando el primaryStatus de está establecido en Aceptar.
estresado
2
 Indica que las funciones del elemento, pero requieren atención. Sobrecarga y sobrecalentado son ejemplos de estados de estresados.
de errores predictivos
3
 Indica que un elemento funciona nominalmente, pero predice un error en un futuro próximo.
error no recuperable
4
 Indica que este elemento está en una condición de error que requiere intervención humana.
entidad auxiliar en de error
5
 Indica que un elemento en el que depende este elemento está en error. Este elemento puede ser ok, pero no puede funcionar debido al estado de un elemento dependiente. Un ejemplo es un servicio de red o un punto de conexión que no puede funcionar debido a problemas de red de nivel inferior.
reservada de DMTF
6 32767
 Reservado.
proveedor reservado
32768 = valor
Reservado.

direccionalidad

Tipo de datos: uint16

Tipo de acceso: solo lectura

Indica la direccionalidad de la canalización. Para canalizaciones unidireccionales, el origen y el receptor se indican mediante una propiedad (SourceOrSink) de la asociación, EndpointOfNetworkPipe.

Esta propiedad se hereda de CIM_NetworkPipe.

desconocido (0)

bidireccional (2)

unidireccional (3)

ElementName

Tipo de datos: de cadena de

Tipo de acceso: solo lectura

Contiene un nombre descriptivo para el objeto. Esta propiedad permite a cada instancia definir un nombre descriptivo además de sus propiedades clave, datos de identidad e información de descripción.

Esta propiedad se hereda de CIM_ManagedElement.

EnabledDefault

Tipo de datos: uint16

Tipo de acceso: lectura y escritura

Valor enumerado que indica la configuración predeterminada o de inicio de un administrador para el estado habilitado de un elemento. De forma predeterminada, el elemento es "Enabled" (value=2).

Esta propiedad se hereda de CIM_EnabledLogicalElement.

habilitado (2)

deshabilitado (3)

no aplicable (5)

habilitado pero sin conexión (6)

sin predeterminado (7)

quiesce (9)

reservado de DMTF (10 32767)

proveedor reservado (32768 65535)

EnabledState

Tipo de datos: uint16

Tipo de acceso: solo lectura

Calificadores: ModelCorrespondence ("CIM_EnabledLogicalElement.OtherEnabledState")

EnabledState es una enumeración entera que indica los estados habilitados y deshabilitados de un elemento. También puede indicar las transiciones entre estos estados solicitados. Por ejemplo, apagar (valor=4) e iniciar (valor=10) son estados transitorios entre habilitado y deshabilitado.

Esta propiedad se hereda de CIM_NetworkPipe.

Valor Significado
desconocido
0
 El estado del elemento es desconocido.
otros
1
 El elemento está en un estado distinto de uno que se muestra aquí.
habilitado para
2
 El elemento es o podría estar ejecutando comandos, procesará los comandos en cola y pondrá en cola nuevas solicitudes.
deshabilitado
3
 El elemento no ejecutará comandos y quitará las nuevas solicitudes.
apagar
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 de prueba
7
 El elemento está en un estado de prueba.
diferido
8
 El elemento podría estar completando comandos, pero pondrá en cola las nuevas solicitudes.
quiesce
9
 El elemento está habilitado, pero en modo restringido.
de inicio
10
 El elemento está en proceso de ir a un estado Habilitado. Las nuevas solicitudes se ponen en cola.
reservada de DMTF
11 32767
proveedor reservado
32768 65535

healthState de

Tipo de datos: uint16

Tipo de acceso: solo lectura

Indica el estado actual del elemento. Este atributo expresa el estado de este elemento, pero no necesariamente el de sus sub-componentes.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Valores Significado
desconocido
0
 La implementación no puede informar sobre HealthState en este momento.
aceptar
5
 El elemento es totalmente funcional y funciona dentro de parámetros operativos normales y sin errores.
degradado o advertencia
10
 El elemento está en orden de trabajo y se proporciona toda la funcionalidad. Sin embargo, el elemento no funciona mejor con sus capacidades. Por ejemplo, es posible que el elemento no funcione con un rendimiento óptimo o que informe de errores recuperables.
de errores menores
15
 Todas las funcionalidades están disponibles, pero algunas podrían degradarse.
error principal
20
 Se produce un error en el elemento. Es posible que algunas o todas las funciones de este componente se degradan o no funcionan.
error crítico
25
 Es posible que el elemento no sea funcional y la recuperación no sea posible.
error no recuperable
30
 El elemento ha producido un error completo y la recuperación no es posible. Se ha perdido toda la funcionalidad proporcionada por este elemento.
reservada de DMTF
31 = valor
DMTF ha reservado la parte sin usar del continuo para valores adicionales de HealthStates en el futuro.

installDate

Tipo de datos: datetime de

Tipo de acceso: solo lectura

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: de cadena de

Tipo de acceso: solo lectura

Calificadores:de clave de

Identifica de forma única y opaca una instancia de esta clase dentro del ámbito del espacio de nombres contenedor.

[! Importante]Para garantizar la unicidad dentro del espacio de nombres, el valor de InstanceID debe construirse en el siguiente patrón:

orgID:localID

orgID debe incluir un nombre único, con derechos de autor o de otro modo único que sea propiedad de la entidad empresarial que define el InstanceIDo ser un identificador registrado asignado por una autoridad global reconocida. Esto es similar a la estructura de nombres de clase Schema. Además, para garantizar la unicidad, los primeros dos puntos de instanceID deben estar entre el orgID de yLocalID. Por lo tanto, el orgID de no debe contener dos puntos (':').

localID la elige la entidad empresarial y no se debe volver a usar para identificar diferentes elementos del mundo real subyacentes.

Si no se usa el patrón anterior, la entidad de definición debe asegurarse de que el InstanceID resultante no se vuelva a usar en ningún InstanceIDproducido por este u otros proveedores para este espacio de nombres.

En el caso de las instancias definidas por el Grupo de tareas de administración distribuida (DMTF), el patrón debe usarse con el OrgID establecido en CIM.

Esta propiedad se hereda de CIM_NetworkPipe.

localAddress

Tipo de datos: de cadena de

Tipo de acceso: solo lectura

Dirección local de la conexión de transporte.

localPort

Tipo de datos: uint16

Tipo de acceso: solo lectura

Puerto local de la conexión de transporte.

nombre de

Tipo de datos: de cadena de

Tipo de acceso: solo lectura

Calificadores: MaxLen (1024)

Indica el nombre descriptivo de esta instancia de un trabajo. Además, el nombre descriptivo se puede usar como propiedad para una búsqueda o consulta.

[! Sugerencia]
Nombre no tiene que ser único dentro de un espacio de nombres.

Esta propiedad se hereda de CIM_ManagedSystemElement.

operatingStatus

Tipo de datos: uint16

Tipo de acceso: solo lectura

Calificadores: ModelCorrespondence ("CIM_EnabledLogicalElement.EnabledState")

Indica la condición operativa actual del elemento. Esta propiedad se puede usar para proporcionar más detalles sobre el estado actual del elemento. También puede indicar estados transitorios. Un valor de NULL indica que la instrumentación no admite esta propiedad.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Valor Significado
desconocido
0
 Indica que la instrumentación no puede informar sobre la propiedad OperatingStatus en este momento.
no disponible
1
 Indica que la instrumentación es capaz de notificar esta propiedad, pero intencionadamente no la notifica para este elemento.
de mantenimiento
2
 Indica que el elemento está en proceso para configurar, mantener, limpiar o administrar de otro modo.
de inicio
3
 Indica que el elemento se está inicializando.
detener
4
 Indica que el elemento se está llevando a una detención ordenada.
detenido
5
 Indica que el elemento se detiene intencionadamente.
anuladas
6
 Indica que el elemento se detuvo de forma inesperada.
inactivos
7
 Indica que el elemento está inactivo o está inactivo.
completado
8
 Indica que el elemento completó su operación. Se recomienda usar valor de propiedad PrimaryStatus de Ok, Erroro Degradado para indicar que la operación se ha realizado correctamente o no.
Migración de
9
 Indica que el elemento se está moviendo entre los elementos host.
de emigración
10
 Indica que el elemento se está alejando del elemento host.
de migración
11
 Indica que el elemento se está moviendo a un nuevo elemento host.
de instantáneas
12
 Indica que se está creando una copia de instantánea del elemento.
apagar
13
 Indica que el elemento se está llevando a una parada abrupta.
en de prueba
14
 Indica que el elemento está realizando funciones de prueba.
de transición
15
 Indica que el elemento está entre estados y no está totalmente disponible en ninguno de los estados. Use otro valor que indique una transición más específica si está disponible.
en service
16
 Indica que el elemento está en servicio y operativo.
reservada de DMTF
17 32767
 Reservado.
proveedor reservado
32768 = valor
Reservado.

OperationalStatus

Tipo de datos: matriz de uint16

Tipo de acceso: solo lectura

Calificadores: ArrayType ("Indexed"), ModelCorrespondence ("CIM_ManagedSystemElement.StatusDescriptions")

Contiene indicadores del estado actual del elemento. El primer valor de OperationalStatus debe contener el estado principal del elemento.

Nota

OperationalStatus reemplaza a la propiedad Status en desuso. Debido al uso generalizado de la propiedad Status existente en las aplicaciones de administración, Microsoft recomienda encarecidamente que los proveedores o la instrumentación proporcionen las propiedades Status y OperationalStatus. Cuando se instrumenta, Estado (porque es de un solo valor) también debe proporcionar el estado principal del elemento.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Valores Significado
desconocido
0
 Indica que la implementación no puede informar sobre operationalStatus en este momento.
otros
1
 Indica un estado indefinido.
aceptar
2
 Indica la funcionalidad completa sin errores.
degradado
3
 Indica que el elemento funciona y se proporciona toda la funcionalidad. Sin embargo, el elemento no funciona mejor con sus capacidades. Por ejemplo, es posible que el elemento no funcione con un rendimiento óptimo o que informe de errores recuperables.
estresado
4
 Indica que el elemento funciona, pero necesita atención. Sobrecarga y sobrecalentado son ejemplos de estados de estresados.
de errores predictivos
5
 Indica que un elemento funciona nominalmente, pero predice un error en un futuro próximo.
error
6
 Indica que se ha producido un error.
error no recuperable
7
 Se ha producido un error irrecuperable.
de inicio
8
 Se está iniciando el trabajo.
detener
9
 El trabajo se está deteniendo.
detenido
10
 El elemento se ha detenido intencionadamente.
en service
11
 Indica que el elemento se está configurando, manteniendo, limpiando o administrando de otro modo.
sin contacto
12
 Indica que el sistema de supervisión tiene conocimiento de este elemento, pero nunca ha podido establecer comunicaciones con él.
de comunicación perdida
13
 Indica que se sabe que el trabajo existe y se ha contactado correctamente en el pasado, pero actualmente no es accesible.
anuladas
14
 Indica que el trabajo se detuvo de forma inesperada. Es posible que sea necesario actualizar el estado y la configuración del trabajo.
inactivos
15
 Indica que el trabajo está inactivo.
entidad auxiliar en de error
16
 Indica que hay un elemento en el que depende este trabajo. Este elemento puede ser ok pero no puede funcionar debido al estado de un elemento dependiente. Un ejemplo es un servicio de red o un punto de conexión que no puede funcionar debido a problemas de red de nivel inferior.
completado
17
 Indica que el trabajo ha completado su operación. Este valor debe combinarse con ok, ErrorError, o degradado para que un cliente pueda saber si la operación completa Completado con Correcto (pasado), Completado con Error (error) o Completado con Degradado (la operación finalizada, pero no se completó Correcto o no notó un error).
modo de energía de
18
 "Power Mode" indica que el elemento tiene información adicional del modelo de energía contenida en la asociación de PowerManagementService asociada.
reservada de DMTF
19 32767
 DMTF ha reservado esta parte del intervalo para valores adicionales de OperationalStatus en el futuro.
proveedor reservado
32768 65535
 Microsoft ha reservado la parte sin usar del intervalo para los valores adicionales de OperationalStatus en el futuro.

OtherEnabledState

Tipo de datos: de cadena de

Tipo de acceso: solo lectura

Calificadores: ModelCorrespondence ("CIM_EnabledLogicalElement.EnabledState")

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.

PrimaryStatus

Tipo de datos: uint16

Tipo de acceso: solo lectura

Calificadores: modelCorrespondence ("CIM_ManagedSystemElement.DetailedStatus", "CIM_ManagedSystemElement.HealthState")

Indica un valor de estado de alto nivel.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Los valores posibles son.

desconocido (0)

aceptar (1)

degradado (2)

error (3)

reservado de DMTF (4 32767)

proveedor reservado (32768 = valor )

RequestedState

Tipo de datos: uint16

Tipo de acceso: lectura y escritura

Calificadores: ModelCorrespondence ("CIM_EnabledLogicalElement.EnabledState")

RequestedState es una enumeración de enteros que indica el último estado solicitado o deseado para el elemento, independientemente del mecanismo mediante el que se solicitó. El estado real del elemento se representa mediante EnabledState. Esta propiedad se proporciona para comparar los últimos estados solicitados y habilitados o deshabilitados actuales. Tenga en cuenta que, cuando EnabledState está establecido en 5 ("No aplicable"), esta propiedad no tiene ningún significado. Consulte la descripción de la propiedad EnabledState para obtener explicaciones de los valores de la enumeración RequestedState.

Esta propiedad se hereda de CIM_NetworkPipe.

Valor Significado
desconocido
0
 El último estado solicitado para el elemento es desconocido.
habilitado para
2
deshabilitado
3
 solicita una deshabilitación inmediata del elemento, de modo que no se ejecutará ni aceptará ningún comando ni solicitudes de procesamiento.
apagar
4
 Solicita una transición ordenada al estado Deshabilitado y podría implicar la eliminación de energía para borrar completamente cualquier estado existente.
sin cambios
5
 En desuso en lugar de indicar que el último estado solicitado es "Desconocido" (0). Si se desconoce el último estado solicitado o deseado, RequestedState debe tener el valor "Unknown" (0), pero puede tener el valor "Sin cambio" (5).
sin conexión
6
 El elemento se ha solicitado para realizar la transición a Enabled pero Offline EnabledState.
de prueba de
7
diferido
8
quiesce
9
reinicio
10
 Hace referencia a hacer un "Apagar" y, a continuación, pasar a un estado "Habilitado".
restablecer
11
 Reset indica que el elemento es primero "Disabled" y, a continuación, "Enabled".
no aplicable
12
 No se admite el conocimiento del último RequestedState para EnabledLogicalElement.
reservada de DMTF
13 32767
proveedor reservado
32768 65535

estado de

Tipo de datos: de cadena de

Tipo de acceso: solo lectura

Calificadores: en desuso ("CIM_ManagedSystemElement.OperationalStatus"), MaxLen (10)

Contiene una cadena que indica el estado principal del objeto.

Nota

Esta propiedad está en desuso y se reemplaza por la propiedad OperationalStatus. Si decide usar la propiedad Status para la compatibilidad con versiones anteriores, debe ser secundaria a la propiedad operationalStatus de.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Los valores posibles son.

("Ok")

("Error")

("Degradado")

("Desconocido")

("Error previo")

("Starting")

("Detener")

("Servicio")

("Estresado")

("NonRecover")

("Sin contacto")

("Lost Comm")

("Detenido")

statusDescriptions

Tipo de datos: cadena matriz

Tipo de acceso: solo lectura

Calificadores: ArrayType ("Indexed"), ModelCorrespondence ("CIM_ManagedSystemElement.OperationalStatus")

Indica descripciones de los valores correspondientes en la matriz de OperationalStatus. Por ejemplo, si un elemento de propiedad OperationalStatus contiene el valor Detener, el elemento del mismo índice de matriz de esta propiedad puede contener una explicación sobre por qué se detiene un objeto.

Esta propiedad se hereda de CIM_ManagedSystemElement.

TimeOfLastStateChange

Tipo de datos: datetime de

Tipo de acceso: solo lectura

Fecha o hora en que el estado habilitado 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 debe actualizarse.

Esta propiedad se hereda de CIM_EnabledLogicalElement.

transitioningToState

Tipo de datos: uint16

Tipo de acceso: solo lectura

Calificadores: ModelCorrespondence ("CIM_EnabledLogicalElement.RequestStateChange", "CIM_EnabledLogicalElement.RequestedState", "CIM_EnabledLogicalElement.EnabledState")

TransitioningToState indica el estado de destino al que se está realizando la transición de la instancia.

Un valor de 5 "Sin cambio" indicará que no hay ninguna transición en curso. Un valor de 12 "No aplicable" indicará que la implementación no admite la representación de transiciones en curso.

Un valor distinto de 5 o 12 identificará el estado al que se encuentra el elemento en el proceso de transición.

Esta propiedad se hereda de CIM_EnabledLogicalElement.

desconocido (0)

habilitado (2)

deshabilitado (3)

apagar (4)

sin cambio (5)

sin conexión (6)

test (7)

aplazar (8)

quiesce (9)

reinicio (10)

restablecer (11)

no aplicable (12)

reservado de DMTF (13 65535)

Requisitos
Cliente mínimo admitido
 Windows 8
Servidor mínimo admitido
 Windows Server 2012
Namespace
 Root\StandardCimv2
MOF
NetTCPIP.mof
DLL
NetTCPIP.dll