MSFT_NetRoute clase

Artículo
03/11/2025

Representa una ruta IP para el proveedor WMIv2 de TCP/IP (Conjunto de protocolos de Internet).

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::Routes"), ClassVersion("1.0.0"), dynamic, provider("nettcpip"), AMENDMENT]
class MSFT_NetRoute : CIM_NextHopRoute
{
  string   Caption;
  string   Description;
  string   ElementName;
  string   InstanceID;
  string   DestinationAddress;
  uint16   AdminDistance;
  uint16   RouteMetric;
  boolean  IsStatic;
  uint16   TypeOfRoute = 3;
  string   DestinationPrefix;
  uint32   InterfaceIndex;
  string   InterfaceAlias;
  string   NextHop;
  uint8    Publish;
  datetime ValidLifetime;
  datetime PreferredLifetime;
  uint8    Store;
  uint16   AddressFamily;
  uint16   Protocol;
};

Miembros

La clase MSFT_NetRoute tiene estos tipos de miembros:

métodos de
propiedades de

Métodos

La clase MSFT_NetRoute tiene estos métodos.

Método	Descripción
Crear	Cree una ruta IP.
Buscar	Recupera una ruta IP a la dirección remota especificada.

Propiedades

La clase MSFT_NetRoute tiene estas propiedades.

AddressFamily

Tipo de datos: uint16
Tipo de acceso: solo lectura

Obtiene un valor que indica si la ruta usa la familia de direcciones IPv4 o IPv6. Esta propiedad obtiene uno de los siguientes valores.

IPv4 (2)
IPv6 (23)

AdminDistance

Tipo de datos: uint16
Tipo de acceso: solo lectura

Distancia administrativa específica de esta ruta, invalidando las distancias predeterminadas especificadas por el sistema o el servicio de enrutamiento.

Esta propiedad se hereda de CIM_NextHopRoute.

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.

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.

DestinationAddress

Tipo de datos: de cadena de
Tipo de acceso: solo lectura

Dirección que actúa como destino al que se va a acceder.

Esta propiedad se hereda de CIM_NextHopRoute.

DestinationPrefix

Tipo de datos: de cadena de
Tipo de acceso: solo lectura

Obtiene el prefijo de destino de la ruta.

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.

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_NextHopRoute.

InterfaceAlias

Tipo de datos: de cadena de
Tipo de acceso: solo lectura

Obtiene el alias de interfaz de la ruta.

InterfaceIndex

Tipo de datos: uint32
Tipo de acceso: solo lectura

Obtiene el índice de interfaz de la ruta.

isStatic

Tipo de datos: booleano
Tipo de acceso: solo lectura

TRUE indica que se trata de una ruta estática y FALSE indica una ruta de aprendizaje dinámico.

Esta propiedad se hereda de CIM_NextHopRoute.

nextHop

Tipo de datos: de cadena de
Tipo de acceso: solo lectura

Obtiene la dirección del próximo salto de la ruta.

preferredLifetime

Tipo de datos: datetime de
Tipo de acceso: lectura y escritura

Obtiene y establece la hora de finalización preferida de la duración de la ruta. El valor predeterminado de esta propiedad es infinito.

de protocolo de

Tipo de datos: uint16
Tipo de acceso: solo lectura

Protocolo desde el que se ha aprendido la ruta.

Valor	Significado
otros 1	otro protocolo
local 2	enrutamiento local
NetMgmt 3	Protocolo de enrutamiento estático de administración de redes (NETMGMT)
icmp 4	Protocolo de mensajes de control de Internet (ICMP)
Egp 5	Protocolo exterior de puerta de enlace (EGP)
Ggp 6	Protocolo de puerta de enlace a puerta de enlace (GGP)
Hello 7	Protocolo Hellospeak (HELLO)
rip 8	Protocolo de información de enrutamiento (RIP)
isIs 9	Sistema intermedio al sistema intermedio (IS-IS)
esIs 10	Sistema final al sistema intermedio (ES-IS)
Igrp 11	Protocolo de enrutamiento de puerta de enlace interior (IGRP)
bbn 12	Protocolo BBN
de Ospf 13	Abrir la ruta de acceso más corta primero (OSPF)
Bgp 14	Protocolo de puerta de enlace de borde (BGP)
idpr 15	Protocolo de enrutamiento entre dominios (IDPR)
Eigrp 16	Protocolo mejorado de enrutamiento de puerta de enlace interior (EIGRP)
dvmrp 17	Protocolo de enrutamiento multidifusión de vector de distancia (DVMRP)
Rpl 18	Protocolo de enrutamiento para redes de Low-Power y pérdida (RPL)
Dhcp 19	Protocolo de configuración dinámica de host (DHCP)

publicar

Tipo de datos: uint8
Tipo de acceso: lectura y escritura

Obtiene y establece un valor que indica cómo anunciar la ruta. El valor predeterminado de esta propiedad es 0.

Valor	Significado
No 0	No anuncie la ruta.
age 1	Anuncie la ruta para un intervalo específico.
sí 2	Anuncie la ruta indefinidamente.

routeMetric

Tipo de datos: uint16
Tipo de acceso: solo lectura

Proporciona una indicación numérica en cuanto a la preferencia de esta ruta, en comparación con otras rutas que llegan al mismo destino.

Esta propiedad se hereda de CIM_NextHopRoute.

Store

Tipo de datos: uint8
Tipo de acceso: solo lectura

Obtiene un valor que indica si el estado de la ruta persiste después de un reinicio. Esta propiedad puede contener uno de los siguientes valores.

Valor	Significado
persistente 0	El estado de la ruta persiste después de un reinicio.
Active 1	El estado de la ruta no persiste después de un reinicio.

TypeOfRoute

Tipo de datos: uint16
Tipo de acceso: solo lectura

Indica el tipo de ruta.

Esta propiedad se hereda de CIM_NextHopRoute.

de ruta definida por el administrador (2)
de ruta calculada (3)
de ruta real (4)

ValidLifetime

Tipo de datos: datetime de
Tipo de acceso: lectura y escritura

Obtiene y establece la hora de finalización válida de la duración de la ruta. El valor predeterminado de esta propiedad es infinito.

Requisitos


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

Consulte también

CIM_NextHopRoute
clases de proveedor netTCPIP

Compartir a través de

MSFT_NetRoute clase

Sintaxis

Miembros

Métodos

Propiedades

Requisitos

Consulte también

Comentarios

Recursos adicionales