Freigeben über

MSFT_NetRoute-Klasse

  • Artikel

Stellt eine IP-Route für den TCP/IP-WMIv2-Anbieter (Internet Protocol Suite) dar.

Die folgende Syntax wurde aus MOF-Code (Managed Object Format, verwaltetes Objektformat) vereinfacht und enthält alle geerbten Eigenschaften.

Syntax

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

Member

Die MSFT_NetRoute-Klasse weist folgende Mitgliedstypen auf:

Methoden

Die MSFT_NetRoute-Klasse weist folgende Methoden auf.

Methode Beschreibung
Erstellen Erstellt eine IP-Route.
Suchen Ruft eine IP-Route an die angegebene Remoteadresse ab.

Eigenschaften

Die MSFT_NetRoute-Klasse weist diese Eigenschaften auf.

AddressFamily

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Ruft einen Wert ab, der angibt, ob die Route die IPv4- oder IPv6-Adressfamilie verwendet. Diese Eigenschaft erhält einen der folgenden Werte.

IPv4 (2)

IPv6 (23)

AdminDistance

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Die spezifische administrative Entfernung dieser Route, wobei alle Standardabstände außer Kraft gesetzt werden, die vom System- oder Routing-Dienst angegeben werden.

Diese Eigenschaft wird von CIM_NextHopRoute geerbt.

Caption

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Kennzeichner: MaxLen (64)

Enthält eine kurze Textbeschreibung des Objekts.

Diese Eigenschaft wird von CIM_ManagedElement geerbt.

Beschreibung

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Bietet eine Textbeschreibung des Objekts.

Diese Eigenschaft wird von CIM_ManagedElement geerbt.

DestinationAddress

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Die Adresse, die als Ziel erreicht werden soll.

Diese Eigenschaft wird von CIM_NextHopRoute geerbt.

DestinationPrefix

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Ruft das Zielpräfix der Route ab.

ElementName

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Enthält einen benutzerfreundlichen Namen für das Objekt. Diese Eigenschaft ermöglicht jeder Instanz, neben den wichtigsten Eigenschaften, den Identitätsdaten und beschreibenden Informationen einen benutzerfreundlichen Namen zu definieren.

Diese Eigenschaft wird von CIM_ManagedElement geerbt.

InstanceID

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Kennzeichner: key

Identifiziert eindeutig und nicht transparent eine Instanz dieser Klasse im Bereich des enthaltenden Namespace.

[!Wichtig]Um die Eindeutigkeit innerhalb des Namespace zu gewährleisten, sollte der Wert von InstanceID gemäß folgendem Muster erstellt werden:

OrgID:LocalID

OrgID muss einen urheberrechtlich geschützten, Marken- oder anderweitig eindeutigen Namen enthalten, der der Geschäftsentität gehört, die die InstanceID definiert, oder eine registrierte ID sein, die von einer anerkannten globalen Autorität zugewiesen wird. Dies ähnelt der Struktur der Schemaklassennamen. Um die Eindeutigkeit des ersten Doppelpunkts in InstanceID sicherzustellen, muss er sich außerdem zwischen der OrgID und localID befinden. Daher darf die OrgID keinen Doppelpunkt („:“) enthalten.

LocalID wird von der Geschäftsentität ausgewählt und sollte nicht wiederverwendet werden, um unterschiedliche zugrunde liegende reale Elemente zu identifizieren.

Wenn das vorherige Muster nicht verwendet wird, muss die definierende Entität sicherstellen, dass die resultierende InstanceID nicht in allen InstanceIDs wiederverwendet wird, die von diesem oder anderen Anbietern dieses Namespace erstellt werden.

Für definierte Instanzen der Distributed Management Task Force (DMTF) muss das Muster verwendet werden, wobei die OrgID auf CIM gesetzt wird.

Diese Eigenschaft wird von CIM_NextHopRoute geerbt.

InterfaceAlias

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Ruft den Schnittstellenalias der Route ab.

InterfaceIndex

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Ruft den Schnittstellenindex der Route ab.

IsStatic

Datentyp: Boolescher Wert

Zugriffstyp: Schreibgeschützt

TRUE gibt an, dass es sich um eine statische Route handelt, und FALSE gibt eine dynamisch gelernte Route an.

Diese Eigenschaft wird von CIM_NextHopRoute geerbt.

NextHop

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Ruft die Adresse des nächsten Hops für die Route ab.

PreferredLifetime

Datentyp: datetime

Zugriffstyp: Lesen/Schreiben

Ruft die bevorzugte Endzeit der Lebensdauer der Route ab und legt sie fest. Der Standardwert dieser Eigenschaft ist unendlich.

Protokoll

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Das Protokoll, aus dem die Route abgerufen wurde.

Wert Bedeutung
Andere
1
 Anderes Protokoll
Lokal
2
 Lokales Routing
NetMgmt
3
 Statisches Netzwerkmanagement-Routingprotokoll (NETMGMT)
Icmp
4
 Internet Control Message Protocol (ICMP)
Egp
5
 Exterior Gateway Protocol (EGP)
Ggp
6
 Gateway-zu-Gateway-Protokoll (GGP)
Hello
7
 Hellospeak-Protokoll (HELLO)
Rip
8
 Routing Information-Protokoll (RIP)
Isis
9
 Zwischensystem zu Zwischensystem (IS-IS)
Esis
10
 Endsystem zu Zwischensystem (ES-IS)
Igrp
11
 Interior Gateway Routing Protocol (IGRP)
Bbn
12
 BBN-Protokoll
Ospf
13
 Open Shortest Path First (OSPF)
Bgp
14
 Border Gateway Protocol (BGP)
Idpr
15
 Interdomain Routing Protocol (IDPR)
Eigrp
16
 Enhanced Interior Gateway Routing Protocol (EIGRP)
Dvmrp
17
 Distance Vector Multicast Routing Protocol (DVMRP)
Rpl
18
 Routing-Protokoll für Low-Power- und Lossy-Netzwerke (RPL)
Dhcp
19
 Dynamic Host Configuration-Protokoll (DHCP)

Veröffentlichen

Datentyp: uint8

Zugriffstyp: Lesen/Schreiben

Dient zum Abrufen und Festlegen eines Werts, der angibt, wie die Route angekündigt wird. Der Standardwert dieser Eigenschaft ist 0.

Wert Bedeutung
Nein
0
 Kündigt die Route nicht an.
Alter
1
 Kündigt die Route für ein bestimmtes Intervall an.
Ja
2
 Kündigt die Route auf unbestimmte Zeit an.

RouteMetric

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Stellt eine numerische Angabe als Einstellung dieser Route im Vergleich zu anderen Routen bereit, die dasselbe Ziel erreichen.

Diese Eigenschaft wird von CIM_NextHopRoute geerbt.

Store

Datentyp: uint8

Zugriffstyp: Schreibgeschützt

Ruft einen Wert ab, der angibt, ob der Status der Route nach einem Neustart beibehalten wird. Diese Eigenschaft kann einen der folgenden Werte enthalten:

Wert Bedeutung
Persistent
0
 Der Status der Route bleibt nach einem Neustart erhalten.
Aktiv
1
 Der Status der Route wird nach einem Neustart nicht beibehalten.

TypeOfRoute

Datentyp: uint16

Zugriffstyp: Schreibgeschützt

Gibt den Typ der Route an.

Diese Eigenschaft wird von CIM_NextHopRoute geerbt.

Vom Administrator definierte Route (2)

Berechnete Route (3)

Aktuelle Route (4)

ValidLifetime

Datentyp: datetime

Zugriffstyp: Lesen/Schreiben

Ruft die gültige Endzeit der Lebensdauer der Route ab und legt sie fest. Der Standardwert dieser Eigenschaft ist unendlich.

Anforderungen
Unterstützte Mindestversion (Client)
 Windows 8
Unterstützte Mindestversion (Server)
 Windows Server 2012
Namespace
 Root\StandardCimv2
MOF
NetTCPIP.mof
DLL
NetTCPIP.dll

Weitere Informationen

CIM_NextHopRoute

NetTCPIP-Anbieterklassen