Compartilhar via

New-AzRouteConfig

  • Referência
Módulo:
Az.Network

Cria uma rota para uma tabela de rotas.

Sintaxe

New-AzRouteConfig
   [-Name <String>]
   [-AddressPrefix <String>]
   [-NextHopType <String>]
   [-NextHopIpAddress <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet New-AzRouteConfig cria uma rota para uma tabela de rotas do Azure.

Exemplos

Exemplo 1: Criar uma rota

$Route = New-AzRouteConfig -Name "Route07" -AddressPrefix 10.1.0.0/16 -NextHopType "VnetLocal"
$Route

Name              : Route07
Id                : 
Etag              : 
ProvisioningState : 
AddressPrefix     : 10.1.0.0/16
NextHopType       : VnetLocal
NextHopIpAddress  :

O primeiro comando cria uma rota chamada Route07 e a armazena na variável $Route. Essa rota encaminha pacotes para a rede virtual local. O segundo comando exibe as propriedades da rota.

Exemplo 2

Cria uma rota para uma tabela de rotas. (gerado automaticamente)

New-AzRouteConfig -AddressPrefix 10.1.0.0/16 -Name 'Route07' -NextHopIpAddress '12.0.0.5' -NextHopType 'VnetLocal'

Exemplo 3: Criar uma rota com uma marca de serviço

New-AzRouteConfig -Name "Route07" -AddressPrefix "AppService" -NextHopType "VirtualAppliance" -NextHopIpAddress "10.0.2.4"

Esse comando cria uma rota chamada Route07 que encaminha o tráfego para prefixos IP contidos na Marca de Serviço AppService para uma solução de virtualização.

Parâmetros

-AddressPrefix

Especifica o destino, no formato CIDR (Roteamento entre Domínios Sem Classificação), ao qual a rota se aplica. Você também pode especificar uma marca de serviço aqui (esse recurso está em visualização pública).

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifica um nome para a rota.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-NextHopIpAddress

Especifica o endereço IP de uma solução de virtualização que você adiciona à sua rede virtual do Azure. Essa rota encaminha pacotes para esse endereço. Especifique esse parâmetro somente se você especificar um valor de VirtualAppliance para o parâmetro NextHopType .

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-NextHopType

Especifica como essa rota encaminha pacotes. Os valores aceitáveis para esse parâmetro são:

  • Internet. O gateway de Internet padrão fornecido pelo Azure.
  • Nenhum. Se você especificar esse valor, a rota não encaminhará pacotes.
  • VirtualAppliance. Uma solução de virtualização que você adiciona à sua rede virtual do Azure.
  • Gateway de Rede Virtual. Um gateway de rede virtual privada de servidor para servidor do Azure.
  • VnetLocal. A rede virtual local. Se você tiver duas sub-redes, 10.1.0.0/16 e 10.2.0.0/16 na mesma rede virtual, selecione um valor de VnetLocal para cada sub-rede a ser encaminhada para a outra sub-rede.
Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

String

Saídas

PSRoute