Set-AzureRoute

  • Referência
Módulo:
Azure

Cria uma rota em uma tabela de rotas.

Observação

Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo herdado do PowerShell não é recomendado ao criar novos recursos, já que o ASM está programado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo do PowerShell recomendado para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.

Sintaxe

Set-AzureRoute
   -RouteName <String>
   -AddressPrefix <String>
   -NextHopType <String>
   [-NextHopIpAddress <String>]
   -RouteTable <IRouteTable>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

O cmdlet Set-AzureRoute cria uma rota em uma tabela de rotas. A nova rota entra em vigor quase imediatamente nas máquinas virtuais associadas à tabela de rotas.

Exemplos

Exemplo 1: Adicionar uma rota de próximo salto de dispositivo virtual

PS C:\> New-AzureRouteTable -Name "ApplianceRouteTable" -Location "Central US" -Label "Appliance Route Table" | Set-AzureRoute -RouteName "ApplianceRoute03" -AddressPrefix "10.0.0.0/24" -NextHopType VirtualAppliance -NextHopIpAddress "10.0.1.5"

Routes                        Name                          Location                      Label
------                        ----                          --------                      -----
{approute}                    AppRT                         Central US                    Appliance Route Table

Esse comando cria uma tabela de rotas chamada ApplianceRouteTable no local especificado. O comando passa essa tabela de rotas para o cmdlet atual. O cmdlet atual adiciona uma rota chamada ApplianceRoute03, que é um tipo de próximo salto do VirtualAppliance. O comando especifica o endereço IP do próximo salto e o prefixo de endereço para a rota.

Exemplo 2: Adicionar uma rota de próximo salto da Internet

PS C:\> Get-AzureRouteTable -Name "ApplianceRouteTable" | Set-AzureRoute -RouteName "InternetRoute" -AddressPrefix "0.0.0.0/0" -NextHopType Internet

Routes                        Name                          Location                      Label
------                        ----                          --------                      -----
{approute, internetroute}     AppRT                         Central US                    Appliance Route Table

Esse comando obtém uma tabela de rotas chamada ApplianceRouteTable. O comando passa essa tabela de rotas para o cmdlet atual. O cmdlet atual adiciona uma rota chamada InternetRoute, que é um tipo de próximo salto da Internet. O comando especifica o prefixo de endereço para a rota.

Parâmetros

-AddressPrefix

Especifica um prefixo de endereço para a nova rota.

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

-NextHopIpAddress

Especifica o endereço IP do dispositivo que é o próximo salto para o tráfego que usa essa rota. Especifique esse valor 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:False
Aceitar caracteres curinga:False

-NextHopType

Especifica o tipo de próximo salto para o tráfego que usa essa rota. Os valores válidos são:

  • VPNGateway
  • VNETLocal
  • Internet
  • VirtualAppliance
  • Nulo
Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Profile

Especifica o perfil do Azure a partir do qual este cmdlet lê. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.

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

-RouteName

Especifica um nome para a nova rota adicionada por esse cmdlet.

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

-RouteTable

Especifica a tabela de rotas à qual esse cmdlet adiciona a nova rota.

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