Set-AzureRoute

  • Referência
Módulo:
Azure

Cria uma rota em uma tabela de rotas.

Nota

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 do PowerShell herdado não é recomendado ao criar novos recursos, uma vez que o ASM está agendado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo 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 salto seguinte do 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

Este 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 do 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

Este 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
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-NextHopType

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

  • VPNGateway
  • VNETLocal
  • Internet
  • VirtualAppliance
  • Nulo
Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Profile

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

Tipo:AzureSMProfile
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RouteName

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

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RouteTable

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

Tipo:IRouteTable
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False