Partager via

Classe MSFT_NetRoute

  • Article

Représente un itinéraire IP pour le fournisseur WMIv2 TCP/IP (Internet Protocol Suite).

La syntaxe suivante est simplifiée par rapport au code MOF (Managed Object Format) et inclut toutes les propriétés héritées.

Syntaxe

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

Membres

La classe MSFT_NetRoute a ces types de membres :

Méthodes

La classe MSFT_NetRoute a ces méthodes.

Méthode Description
Créer Créez un itinéraire IP.
Rechercher Récupère un itinéraire IP vers l’adresse distante spécifiée.

Propriétés

La classe MSFT_NetRoute possède ces propriétés.

AddressFamily

Type de données : uint16

Type d’accès : Lecture seule

Obtient une valeur qui indique si l’itinéraire utilise la famille d’adresses IPv4 ou IPv6. Cette propriété reçoit l’une des valeurs suivantes.

IPv4 (2)

IPv6 (23)

AdminDistance

Type de données : uint16

Type d’accès : Lecture seule

La distance administrative spécifique de cet itinéraire ;remplace toutes les distances par défaut spécifiées par le système ou le service de routage.

Cette propriété est héritée de CIM_NextHopRoute.

Caption

Type de données : chaîne

Type d’accès : Lecture seule

Qualificateurs : MaxLen (64)

Contient une brève description textuelle de l’objet.

Cette propriété est héritée de CIM_ManagedElement.

Description

Type de données : chaîne

Type d’accès : Lecture seule

Fournit une description textuelle de l’objet.

Cette propriété est héritée de CIM_ManagedElement.

DestinationAddress

Type de données : chaîne

Type d’accès : Lecture seule

Adresse servant de destination à atteindre.

Cette propriété est héritée de CIM_NextHopRoute.

DestinationPrefix

Type de données : chaîne

Type d’accès : Lecture seule

Obtient le préfixe de destination de l’itinéraire.

ElementName

Type de données : chaîne

Type d’accès : Lecture seule

Contient un nom convivial pour l’objet. Cette propriété permet à chaque instance de définir un nom convivial en plus de ses propriétés clés, ses données d’identité et ses informations de description.

Cette propriété est héritée de CIM_ManagedElement.

InstanceID

Type de données : chaîne

Type d’accès : Lecture seule

Qualificateurs : clé

Identifie de manière opaque et unique une instance de cette classe dans le cadre de l’espace de noms contenant.

[!Important]Pour garantir l’unicité dans l’espace de noms, la valeur d’InstanceID doit être construite selon le modèle suivant :

OrgID:LocalID

OrgID doit inclure un nom protégé par droit d’auteur, une marque ou un nom unique appartenant à l’entité commerciale définissant InstanceID, ou être un ID inscrit attribué par une autorité globale reconnue. Il s’agit d’une structure similaire à la structure des noms de classe Schema. De plus, pour garantir l’unicité, le premier signe deux-points dans InstanceID doit être compris entre OrgID et LocalID. Pour cela, OrgID ne doit pas contenir de signe deux-points (’:’).

LocalID est choisi par l’entité commerciale et ne doit pas être réutilisé pour identifier différents éléments sous-jacents du monde réel.

Si le modèle ci-dessus n’est pas utilisé, l’entité de définition doit garantir que l’InstanceID résultant n’est pas réutilisé dans les InstanceID produits par ce fournisseur ou par d’autres pour cet espace de noms.

Pour les instances définies par la DMTF (Distributed Management Task Force), le modèle doit être utilisé avec OrgID défini sur CIM.

Cette propriété est héritée de CIM_NextHopRoute.

InterfaceAlias

Type de données : chaîne

Type d’accès : Lecture seule

Obtient l’alias d’interface de l’itinéraire.

InterfaceIndex

Type de données : uint32

Type d’accès : Lecture seule

Obtient l’index d’interface de l’itinéraire.

IsStatic

Type de données : booléen

Type d’accès : Lecture seule

TRUE indique qu’il s’agit d’un itinéraire statique, FALSE désignant un itinéraire appris dynamiquement.

Cette propriété est héritée de CIM_NextHopRoute.

NextHop

Type de données : chaîne

Type d’accès : Lecture seule

Obtient l’adresse du tronçon suivant de l’itinéraire.

PreferredLifetime

Type de données : DateHeure

Type d’accès : lecture/écriture

Obtient et définit l’heure de fin préférée de la durée de vie de l’itinéraire. La valeur par défaut de cette propriété est infinie.

Protocole

Type de données : uint16

Type d’accès : Lecture seule

Le protocole à partir duquel l’itinéraire a été appris.

Valeur Signification
Autres
1
 autre protocole
Local
2
 itinéraire local
NetMgmt
3
 NETMGMT (protocole de routage statique de gestion réseau)
Icmp
4
 ICMP
Egp
5
 Exterior Gateway Protocol (EGP)
Ggp
6
 GGP (Protocole de passerelle à passerelle)
Bonjour
7
 HELLO (protocole Hellospeak)
Rip
8
 Protocole RIP (Routing Information Protocol)
IsIs
9
 IS-IS (système intermédiaire vers système intermédiaire)
EsIs
10
 ES-IS (Mettre fin au système intermédiaire)
Igrp
11
 Protocole IGRP (Interior Gateway Routing Protocol)
Bbn
12
 Protocole BBN
Ospf
13
 protocole OSPF (Open Shortest Path First)
Bgp
14
 BGP (Border Gateway Protocol)
Idpr
15
 IDPR (Protocole de routage interdomaine)
Eigrp
16
 EIGRP (Protocole de routage de passerelle intérieure améliorée)
Dvmrp
17
 Protocole DVMRP (Distance Vector Multicast Routing Protocol)
Rpl
18
 RPL (Protocole de routage pour les réseaux à faible alimentation et à perte)
Dhcp
19
 Protocole DHCP (Dynamic Host Configuration Protocol)

Publier

Type de données : uint8

Type d’accès : lecture/écriture

Obtient et définit une valeur qui indique comment annoncer l’itinéraire. La valeur par défaut de cette propriété est 0.

Valeur Signification
Aucun
0
 N’annoncez pas l’itinéraire.
Age
1
 Annoncez l’itinéraire pour un intervalle spécifique.
Oui
2
 annoncez l’itinéraire indéfiniment.

RouteMetric

Type de données : uint16

Type d’accès : Lecture seule

Fournit une indication numérique quant à la préférence de cet itinéraire par rapport aux autres itinéraires qui atteignent la même destination.

Cette propriété est héritée de CIM_NextHopRoute.

Magasin

Type de données : uint8

Type d’accès : Lecture seule

Obtient une valeur qui indique si le l’état de l’interface persiste après un redémarrage. Cette propriété peut contenir l’une des valeurs suivantes.

Valeur Signification
Persistent
0
 L’état de l’itinéraire persiste après un redémarrage.
Actif
1
 L’état de l’itinéraire ne persiste pas après un redémarrage.

TypeOfRoute

Type de données : uint16

Type d’accès : Lecture seule

Indique le type d’itinéraire.

Cette propriété est héritée de CIM_NextHopRoute.

Itinéraire défini par l’administrateur (2)

Itinéraire calculé (3)

Itinéraire réel (4)

ValidLifetime

Type de données : DateHeure

Type d’accès : lecture/écriture

Obtient et définit l’heure de fin valide de la durée de vie de l’itinéraire. La valeur par défaut de cette propriété est infinie.

Spécifications
Client minimal pris en charge
 Windows 8
Serveur minimal pris en charge
 Windows Server 2012
Espace de noms
 Root\StandardCimv2
MOF
NetTCPIP.mof
DLL
NetTCPIP.dll

Voir aussi

CIM_NextHopRoute

Classes de fournisseurs NetTCPIP