Condividi tramite

Set-AzureRoute

  • Riferimento
Modulo:
Azure

Crea una route in una tabella di route.

Nota

I cmdlet a cui si fa riferimento in questa documentazione sono per la gestione delle risorse di Azure legacy che usano le API di Azure Service Manager (ASM). Questo modulo di PowerShell legacy non è consigliato durante la creazione di nuove risorse perché ASM è pianificato per il ritiro. Per altre informazioni, vedere Ritiro di Azure Service Manager.

Il modulo Az PowerShell è il modulo PowerShell consigliato per la gestione delle risorse di Azure Resource Manager (ARM) con PowerShell.

Sintassi

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

Descrizione

Il cmdlet Set-AzureRoute crea una route in una tabella di route. La nuova route ha effetto quasi immediatamente sulle macchine virtuali associate alla tabella di route.

Esempio

Esempio 1: Aggiungere una route hop successiva dell'appliance virtuale

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

Questo comando crea una tabella di route denominata ApplianceRouteTable nella posizione specificata. Il comando passa tale tabella di route al cmdlet corrente. Il cmdlet corrente aggiunge una route denominata ApplianceRoute03, ovvero un tipo di hop successivo VirtualAppliance. Il comando specifica l'indirizzo IP dell'hop successivo e il prefisso dell'indirizzo per la route.

Esempio 2: Aggiungere una route hop successivo 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

Questo comando ottiene una tabella di route denominata ApplianceRouteTable. Il comando passa tale tabella di route al cmdlet corrente. Il cmdlet corrente aggiunge una route denominata InternetRoute, ovvero un tipo di hop successivo Internet. Il comando specifica il prefisso dell'indirizzo per la route.

Parametri

-AddressPrefix

Specifica un prefisso di indirizzo per la nuova route.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NextHopIpAddress

Specifica l'indirizzo IP dell'appliance che rappresenta l'hop successivo per il traffico che usa questa route. Specificare questo valore solo se si specifica il valore VirtualAppliance per il parametro NextHopType .

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NextHopType

Specifica il tipo di hop successivo per il traffico che usa questa route. I valori validi sono:

  • VPNGateway
  • VNETLocal
  • Internet
  • VirtualAppliance
  • Null
Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Profile

Specifica il profilo di Azure da cui viene letto questo cmdlet. Se non si specifica un profilo, questo cmdlet legge dal profilo predefinito locale.

Tipo:AzureSMProfile
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RouteName

Specifica un nome per la nuova route aggiunta da questo cmdlet.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RouteTable

Specifica la tabella di route a cui questo cmdlet aggiunge la nuova route.

Tipo:IRouteTable
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False