New-AzRouteConfig

Módulo:
Az.Network Module

Cria uma rota para uma tabela de rotas.

Sintaxe

Default (Predefinição) 

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

Descrição

O cmdlet New-AzRouteConfig cria uma rota para uma tabela de rotas 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, em seguida, armazena-a 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. (autogenerated)

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

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

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

Este comando cria uma rota chamada Route07 que encaminha o tráfego para prefixos IP contidos na AppService Service Tag para um dispositivo virtual.

Parâmetros

-AcquirePolicyToken

Adquira automaticamente um token Azure Policy para esta operação de recurso.

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-AddressPrefix

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

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-ChangeReference

A alteração do ID de referência do recurso para esta operação de recurso.

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Cf.

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DefaultProfile

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

Propriedades dos parâmetros

Tipo:IAzureContextContainer
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Name

Especifica um nome para a rota.

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-NextHopIpAddress

Especifica o(s) endereço(s) IP do próximo salto para onde esta rota encaminha os pacotes. Para um NextHopType de VirtualAppliance, forneça um único endereço IP de um appliance virtual que adiciona à sua rede virtual Azure. Para um NextHopType de VirtualApplianceEcmp, forneça entre 2 e 64 endereços IP para balancear o tráfego através do encaminhamento multi-path (ECMP) de custo igual.

Propriedades dos parâmetros

Tipo:

String[]

Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-NextHopType

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

  • Internet. O gateway de Internet predefinido fornecido pelo Azure.
  • Nenhum. Se você especificar esse valor, a rota não encaminhará pacotes.
  • VirtualAppliance. Um appliance virtual que adiciona à sua rede virtual Azure.
  • VirtualApplianceEcmp. Múltiplos appliances virtuais cujo tráfego é balanceado em carga usando o encaminhamento multi-path (ECMP) de custo igual. Forneça os endereços IP do aparelho através do parâmetro NextHopIpAddress .
  • VirtualNetworkGateway. Um gateway virtual de rede privada Azure server-to-server.
  • 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 para encaminhar para a outra sub-rede.

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-WhatIf

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Wi

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

String

Saídas

PSRoute