Partilhar via

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 de Gerenciamento de Serviços. Consulte o módulo Az PowerShell para cmdlets para 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 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.

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 próximo tipo de 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 é lido. 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