MSFT_NetRoute 클래스

아티클
05/16/2024

TCP/IP(인터넷 프로토콜 제품군) WMIv2 공급자에 대한 IP 경로를 나타냅니다.

다음 구문은 MOF(Managed Object Format) 코드를 단순화한 것으로 상속된 속성이 모두 포함되어 있습니다.

구문

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

멤버

MSFT_NetRoute 클래스에는 다음과 같은 유형의 멤버가 있습니다.

Methods
Properties

메서드

MSFT_NetRoute 클래스에는 다음과 같은 메서드가 있습니다.

메서드	설명
만들기	IP 경로를 만듭니다.
Find	지정된 원격 주소에 대한 IP 경로를 검색합니다.

속성

MSFT_NetRoute 클래스에는 이러한 속성이 있습니다.

AddressFamily

데이터 형식: uint16
액세스 형식: 읽기 전용

경로에서 IPv4 또는 IPv6 주소 패밀리를 사용하는지 여부를 나타내는 값을 가져옵니다. 이 속성은 다음 값 중 하나를 가져옵니다.

IPv4(2)
IPv6(23)

AdminDistance

데이터 형식: uint16
액세스 형식: 읽기 전용

시스템 또는 라우팅 서비스에서 지정한 기본 거리를 재정의하는 이 경로의 특정 관리 거리입니다.

이 속성은 CIM_NextHopRoute에서 상속됩니다.

캡션

데이터 형식: string
액세스 형식: 읽기 전용
한정자: MaxLen(64)

개체에 대한 간단한 텍스트 설명이 포함되어 있습니다.

이 속성은 CIM_ManagedElement에서 상속됩니다.

설명

데이터 형식: string
액세스 형식: 읽기 전용

개체에 대한 텍스트 설명을 제공합니다.

이 속성은 CIM_ManagedElement에서 상속됩니다.

DestinationAddress

데이터 형식: string
액세스 형식: 읽기 전용

도달할 목적지 역할을 하는 주소입니다.

이 속성은 CIM_NextHopRoute에서 상속됩니다.

DestinationPrefix

데이터 형식: string
액세스 형식: 읽기 전용

경로의 대상 접두사를 가져옵니다.

ElementName

데이터 형식: string
액세스 형식: 읽기 전용

사용자에게 친숙한 개체 이름이 포함되어 있습니다. 이 속성을 사용하면 각 인스턴스가 키 속성, ID 데이터 및 설명 정보 외에도 사용자에게 친숙한 이름을 정의할 수 있습니다.

이 속성은 CIM_ManagedElement에서 상속됩니다.

InstanceID

데이터 형식: string
액세스 형식: 읽기 전용
한정자: 키

포함된 네임스페이스의 범위 내에서 이 클래스의 인스턴스를 고유하고 불투명하게 식별합니다.

[!중요]네임스페이스 내에서 고유성을 보장하려면 다음 패턴으로 InstanceID 값을 구성해야 합니다.

OrgID:LocalID

OrgID는 InstanceID를 정의하는 비즈니스 엔터티가 소유하는 저작권, 상표규ㅗㄴ 또는 기타 고유한 이름을 포함하거나 공인된 글로벌 기관에서 할당한 등록 ID여야 합니다. 이는 스키마 클래스 이름의 구조와 비슷합니다. 또한 고유성을 보장하려면 InstanceID의 첫 번째 콜론이 OrgID와 LocalID 사이에 있어야 합니다. 따라서 OrgID에는 콜론(':')이 포함되어서는 안 됩니다.

LocalID는 비즈니스 엔터티에 의해 선택되며 다른 기본 실제 요소를 식별하는 데 다시 사용해서는 안 됩니다.

위의 패턴을 사용하지 않는 경우 정의 엔터티는 이 네임스페이스 또는 이 네임스페이스에 대해 다른 공급자가 생성한 모든 InstanceID에서 결과 InstanceID가 다시 사용되지 않도록 해야 합니다.

DMTF(분산 관리 태스크 포스) 정의 인스턴스의 경우 OrgID가 CIM으로 설정된 패턴을 사용해야 합니다.

이 속성은 CIM_NextHopRoute에서 상속됩니다.

InterfaceAlias

데이터 형식: string
액세스 형식: 읽기 전용

경로의 인터페이스 별칭을 가져옵니다.

InterfaceIndex

데이터 형식: uint32
액세스 형식: 읽기 전용

경로의 인터페이스 인덱스를 가져옵니다.

IsStatic

데이터 형식: boolean
액세스 형식: 읽기 전용

TRUE는 이것이 정적 경로임을 나타내고 FALSE는 동적으로 학습된 경로를 나타냅니다.

이 속성은 CIM_NextHopRoute에서 상속됩니다.

NextHop

데이터 형식: string
액세스 형식: 읽기 전용

경로에 대한 다음 홉의 주소를 가져옵니다.

PreferredLifetime

데이터 형식: datetime
액세스 형식: 읽기/쓰기

경로 수명 동안 기본 설정 종료 시간을 가져오고 설정합니다. 이 속성의 기본값은 infinite입니다.

프로토콜

데이터 형식: uint16
액세스 형식: 읽기 전용

경로를 학습한 프로토콜입니다.

값	의미
Other 1	기타 프로토콜
로컬 2	로컬 라우팅
NetMgmt 3	NETMGMT(네트워크 관리 정적 라우팅 프로토콜)
Icmp 4	ICMP(Internet Control Message Protocol)
Egp 5	EGP(외부 게이트웨이 프로토콜)
Ggp 6	GGP(게이트웨이-게이트웨이 프로토콜)
Hello 7	Hellospeak 프로토콜(HELLO)
Rip 8	RIP(Routing Information Protocol)
IsIs 9	IS-IS(중간 시스템-중간 시스템)
EsIs 10	ES-IS(엔드 시스템-중간 시스템)
Igrp 11	IGRP(내부 게이트웨이 라우팅 프로토콜)
Bbn 12	BBN 프로토콜
Ospf 13	OSPF(최단 경로 우선 프로토콜)
Bgp 14	BGP(Border Gateway Protocol)
Idpr 15	IDPR(도메인 간 라우팅 프로토콜)
Eigrp 16	향상된 EIGRP(내부 게이트웨이 라우팅 프로토콜)
Dvmrp 17	DVMRP(거리 벡터 멀티캐스트 라우팅 프로토콜)
Rpl 18	RPL(저전력 및 손실) 네트워크용 라우팅 프로토콜
Dhcp 19	DHCP(Dynamic Host Configuration Protocol)

게시

데이터 형식: uint8
액세스 형식: 읽기/쓰기

경로를 보급하는 방법을 나타내는 값을 가져오고 설정합니다. 이 속성의 기본값은 0입니다.

값	의미
문제 0	경로를 보급하지 않습니다.
Age 1	특정 간격에 대한 경로를 보급합니다.
예 2	경로를 무기한 보급합니다.

RouteMetric

데이터 형식: uint16
액세스 형식: 읽기 전용

동일한 목적지에 도달하는 다른 경로와 비교하여 이 경로의 기본 설정에 대한 숫자 표시를 제공합니다.

이 속성은 CIM_NextHopRoute에서 상속됩니다.

저장

데이터 형식: uint8
액세스 형식: 읽기 전용

다시 부팅한 후 경로의 상태가 지속되는지 여부를 나타내는 값을 가져옵니다. 이 속성은 다음 값 중 하나를 포함할 수 있습니다.

값	의미
Persistent 0	다시 부팅한 후에도 경로의 상태가 유지됩니다.
진행 중 1	다시 부팅한 후 경로의 상태가 유지되지 않습니다.

TypeOfRoute

데이터 형식: uint16
액세스 형식: 읽기 전용

경로 유형을 나타냅니다.

이 속성은 CIM_NextHopRoute에서 상속됩니다.

관리자 정의 경로(2)
계산된 경로(3)
실제 경로(4)

ValidLifetime

데이터 형식: datetime
액세스 형식: 읽기/쓰기

경로 수명 동안 유효한 종료 시간을 가져오고 설정합니다. 이 속성의 기본값은 infinite입니다.

요구 사항


지원되는 최소 클라이언트	Windows 8
지원되는 최소 서버	Windows Server 2012
네임스페이스	Root\StandardCimv2
MOF	NetTCPIP.mof
DLL	NetTCPIP.dll

참고 항목

CIM_NextHopRoute
NetTCPIP 공급자 클래스

다음을 통해 공유

MSFT_NetRoute 클래스

구문

멤버

메서드

속성

요구 사항

참고 항목

피드백

추가 리소스