Set-AzureRoute

  • Referência
Módulo:
Azure

Cria uma rota em uma tabela de rotas.

Observação

Os cmdlets mostrados nesta documentação são usados para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Confira o módulo Az PowerShell para usar cmdlets a fim de gerenciar recursos do Azure Resource Manager.

Syntax

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.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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 .

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RouteName

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RouteTable

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

Type:IRouteTable
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False