MSFT_NetRoute classe

Artigo
05/09/2024

Representa uma rota IP para o provedor WMIv2 TCP/IP (Internet Protocol Suite).

A sintaxe a seguir é simplificada do código MOF (Managed Object Format) e inclui todas as propriedades herdadas.

Sintaxe

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

Membros

A classe MSFT_NetRoute tem estes tipos de membros:

Métodos
Propriedades

Métodos

A classe MSFT_NetRoute tem esses métodos.

Método	Descrição
Criar	Crie uma rota IP.
Localizar	Recupera uma rota IP para o endereço remoto especificado.

Propriedades

A classe MSFT_NetRoute tem essas propriedades.

EndereçoFamília

Tipo de dados: uint16
Tipo de acesso: Somente leitura

Obtém um valor que indica se a rota usa a família de endereços IPv4 ou IPv6. Essa propriedade obtém um dos seguintes valores.

IPv4 (2)
IPv6 (23)

AdminDistance

Tipo de dados: uint16
Tipo de acesso: Somente leitura

A distância administrativa específica dessa rota, substituindo quaisquer distâncias padrão especificadas pelo sistema ou serviço de roteamento.

Essa propriedade é herdada de CIM_NextHopRoute.

Legenda

Tipo de dados: string
Tipo de acesso: Somente leitura
Qualificadores: Comprimento Máximo (64)

Contém uma breve descrição textual do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Descrição

Tipo de dados: string
Tipo de acesso: Somente leitura

Fornece uma descrição textual do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Endereço de Destino

Tipo de dados: string
Tipo de acesso: Somente leitura

O endereço que serve como destino a ser alcançado.

Essa propriedade é herdada de CIM_NextHopRoute.

DestinationPrefix

Tipo de dados: string
Tipo de acesso: Somente leitura

Obtém o prefixo de destino da rota.

ElementName

Tipo de dados: string
Tipo de acesso: Somente leitura

Contém um nome amigável para o objeto. Essa propriedade permite que cada instância defina um nome amigável, além de suas propriedades de chave, dados de identidade e informações de descrição.

Essa propriedade é herdada de CIM_ManagedSystemElement.

InstanceID

Tipo de dados: string
Tipo de acesso: Somente leitura
Qualificadores: key

Identifica de forma exclusiva e opaca uma instância dessa classe dentro do escopo do namespace que contém.

[! Importante]Para garantir a exclusividade dentro do Namespace, o valor de InstanceID deve ser construído no seguinte padrão:

OrgID:LocalID

OrgID deve incluir um nome protegido por direitos autorais, marca registrada ou de outra forma exclusivo que seja de propriedade da entidade comercial que define o InstanceID ou ser um ID registrado atribuído por uma autoridade global reconhecida. Isso é semelhante à estrutura de nomes de classe de esquema. Além disso, para garantir a exclusividade, os primeiros dois pontos em InstanceID devem estar entre OrgID eLocalID. Portanto, o OrgID não deve conter dois pontos (':').

O LocalID é escolhido pela entidade de negócios e não deve ser reutilizado para identificar diferentes elementos subjacentes do mundo real.

Se o padrão anterior não for usado, a entidade definidora deverá garantir que o InstanceID resultante não seja reutilizado em nenhum InstanceIDs produzido por este ou outros provedores para este Namespace.

Para instâncias definidas pela DMTF (Distributed Management Task Force), o padrão deve ser usado com o OrgID definido como CIM.

Essa propriedade é herdada de CIM_NextHopRoute.

InterfaceAlias

Tipo de dados: string
Tipo de acesso: Somente leitura

Obtém o alias de interface da rota.

InterfaceIndex

Tipo de dados: uint32
Tipo de acesso: Somente leitura

Obtém o índice de interface da rota.

IsStatic

Tipo de dados: boolean
Tipo de acesso: Somente leitura

TRUE indica que essa é uma rota estática e FALSE indica uma rota aprendida dinamicamente.

Essa propriedade é herdada de CIM_NextHopRoute.

PróximoSalto

Tipo de dados: string
Tipo de acesso: Somente leitura

Obtém o endereço do próximo salto para a rota.

PreferredLifetime

Tipo de dados: datetime
Tipo de acesso: leitura/gravação

Obtém e define a hora de término preferida da vida útil da rota. O valor padrão para essa propriedade é infinito.

Protocolo

Tipo de dados: uint16
Tipo de acesso: Somente leitura

O protocolo a partir do qual a rota foi aprendida.

Valor	Significado
Outras 1	outro protocolo
Local 2	Roteamento local
NetMgmt 3	Protocolo de roteamento estático de gerenciamento de rede (NETMGMT)
Icmp 4	Protocolo ICMP
Egp 5	Protocolo de gateway exterior (EGP)
Ggp 6	Protocolo Gateway-to-Gateway (GGP)
Olá 7	Protocolo Hellospeak (HELLO)
Rasgar 8	Protocolo RIP
Ísis 9	Sistema Intermediário para Sistema Intermediário (IS-IS)
EsIs 10	Sistema Final para Sistema Intermediário (ES-IS)
Igrp 11	Protocolo de Roteamento de Gateway Interior (IGRP)
Bbn 12	Protocolo BBN
Ospf 13	Abrir primeiro o caminho mais curto (OSPF)
Bgp 14	BGP (Border Gateway Protocol)
Idpr 15	Protocolo de Roteamento entre Domínios (IDPR)
Eigrp 16	Protocolo de Roteamento de Gateway Interior Avançado (EIGRP)
Dvmrp 17	Protocolo de Roteamento Multicast de Vetor de Distância (DVMRP)
Rpl 18	Protocolo de roteamento para redes de baixo consumo de energia e com perdas (RPL)
Dhcp 19	Protocolo DHCP

Publicar

Tipo de dados: uint8
Tipo de acesso: leitura/gravação

Obtém e define um valor que indica como anunciar a rota. O valor padrão para essa propriedade é 0.

Valor	Significado
Não 0	Não anuncie a rota.
Age 1	Anuncie a rota para um intervalo específico.
Sim 2	Anuncie a rota por tempo indeterminado.

RouteMetric

Tipo de dados: uint16
Tipo de acesso: Somente leitura

Fornece uma indicação numérica quanto à preferência desta rota, em comparação com outras rotas que chegam ao mesmo destino.

Essa propriedade é herdada de CIM_NextHopRoute.

Store

Tipo de dados: uint8
Tipo de acesso: Somente leitura

Obtém um valor que indica se o estado da rota persiste após uma reinicialização. Essa propriedade pode conter um dos seguintes valores.

Valor	Significado
Persistente 0	O estado da rota persiste após uma reinicialização.
Com atividade 1	O estado da rota não persiste após uma reinicialização.

TypeOfRoute

Tipo de dados: uint16
Tipo de acesso: Somente leitura

Indica o tipo de rota.

Essa propriedade é herdada de CIM_NextHopRoute.

Rota definida pelo administrador (2)
Rota Computada (3)
Rota real (4)

Vitalício do ValidLifetime

Tipo de dados: datetime
Tipo de acesso: leitura/gravação

Obtém e define a hora de término válida do tempo de vida da rota. O valor padrão para essa propriedade é infinito.

Requisitos


Cliente mínimo com suporte	Windows 8
Servidor mínimo com suporte	Windows Server 2012
Namespace	Raiz\StandardCimv2
MOF	NetTCPIP.mof
DLL	NetTCPIP.dll

Confira também

CIM_NextHopRoute
Classes de provedor NetTCPIP

Compartilhar via

MSFT_NetRoute classe

Sintaxe

Membros

Métodos

Propriedades

Requisitos

Confira também

Comentários

Recursos adicionais