Condividi tramite

Add-AzRouteConfig

Modulo:
Az.Network Module

Aggiunge un'instradamento a una tabella di instradamento.

Sintassi

Default (Impostazione predefinita) 

Add-AzRouteConfig
    -RouteTable <PSRouteTable>
    [-Name <String>]
    [-AddressPrefix <String>]
    [-NextHopType <String>]
    [-NextHopIpAddress <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Descrizione

Il cmdlet Add-AzRouteConfig aggiunge una route a una tabella di route di Azure.

Esempio

Esempio 1: Aggiungere una route a una tabella di route

$RouteTable = Get-AzRouteTable -ResourceGroupName "ResourceGroup11" -Name "RouteTable01"
Add-AzRouteConfig -Name "Route13" -AddressPrefix 10.3.0.0/16 -NextHopType "VnetLocal" -RouteTable $RouteTable

Il primo comando ottiene una tabella di route denominata RouteTable01 usando il cmdlet Get-AzRouteTable. Il comando archivia la tabella nella variabile $RouteTable. Il secondo comando aggiunge una route denominata Route13 alla tabella di route archiviata in $RouteTable. Questa route inoltra i pacchetti alla rete virtuale locale.

Esempio 2: Aggiungere una route a una tabella di route usando la pipeline

Get-AzRouteTable -ResourceGroupName "ResourceGroup11" -Name "RouteTable01" | Add-AzRouteConfig -Name "Route02" -AddressPrefix 10.2.0.0/16 -NextHopType VnetLocal | Set-AzRouteTable

Name              : routetable01
ResourceGroupName : ResourceGroup11
Location          : eastus
Id                : /subscriptions/xxxx-xxxx-xxxx-xxxx/resourceGroups/ResourceGroup11/providers/Microsoft.Networ
                    k/routeTables/routetable01
Etag              : W/"f13e1bc8-d41f-44d0-882d-b8b5a1134f59"
ProvisioningState : Succeeded
Tags              :
Routes            : [
                      {
                        "Name": "route07",
                        "Etag": "W/\"f13e1bc8-d41f-44d0-882d-b8b5a1134f59\"",
                        "Id": "/subscriptions/xxxx-xxxx-xxxx-xxxx/resourceGroups/ResourceGroup11/providers/Micro
                    soft.Network/routeTables/routetable01/routes/route07",
                        "AddressPrefix": "10.1.0.0/16",
                        "NextHopType": "VnetLocal",
                        "NextHopIpAddress": null,
                        "ProvisioningState": "Succeeded"
                      },
                      {
                        "Name": "route02",
                        "Etag": "W/\"f13e1bc8-d41f-44d0-882d-b8b5a1134f59\"",
                        "Id": "/subscriptions/xxxx-xxxx-xxxx-xxxx/resourceGroups/ResourceGroup11/providers/Micro
                    soft.Network/routeTables/routetable01/routes/route02",
                        "AddressPrefix": "10.2.0.0/16",
                        "NextHopType": "VnetLocal",
                        "NextHopIpAddress": null,
                        "ProvisioningState": "Succeeded"
                      },
                      {
                        "Name": "route13",
                        "Etag": null,
                        "Id": null,
                        "AddressPrefix": "10.3.0.0/16",
                        "NextHopType": "VnetLocal",
                        "NextHopIpAddress": null,
                        "ProvisioningState": null
                      }
                    ]
Subnets           : []

Questo comando ottiene la tabella di route denominata RouteTable01 usando Get-AzRouteTable. Il comando passa tale tabella al cmdlet corrente usando l'operatore pipeline. Il cmdlet corrente aggiunge la route denominata Route02 e quindi passa il risultato al cmdlet Set-AzRouteTable , che aggiorna la tabella in modo da riflettere le modifiche.

Esempio 3: Aggiungere una route con un tag di servizio a una tabella di route (anteprima pubblica)

$RouteTable = Get-AzRouteTable -ResourceGroupName "ResourceGroup11" -Name "RouteTable01"
Add-AzRouteConfig -Name "Route13" -AddressPrefix "AppService" -NextHopType "VirtualAppliance" -NextHopIpAddress "10.0.2.4" -RouteTable $RouteTable

Il primo comando ottiene una tabella di route denominata RouteTable01 usando il cmdlet Get-AzRouteTable. Il comando archivia la tabella nella variabile $RouteTable. Il secondo comando aggiunge una route denominata Route13 alla tabella di route archiviata in $RouteTable. Questa route inoltra il traffico ai prefissi IP contenuti nel tag del servizio AppService a un'appliance virtuale.

Parametri

-AddressPrefix

Specifica la destinazione, in formato CIDR (Classless Interdomain Routing), a cui si applica la route. È anche possibile specificare un tag di servizio qui (questa funzionalità è disponibile in anteprima pubblica).

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Proprietà dei parametri

Tipo:IAzureContextContainer
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Name

Specifica un nome della route da aggiungere alla tabella di route.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-NextHopIpAddress

Specifica l'indirizzo IP di un'appliance virtuale aggiunta alla rete virtuale di Azure. Questa route inoltra i pacchetti a tale indirizzo. Specificare questo parametro solo se si specifica il valore VirtualAppliance per il parametro NextHopType .

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-NextHopType

Specifica il modo in cui questa route inoltra i pacchetti. I valori accettabili per questo parametro sono:

  • Internet. Gateway Internet predefinito fornito da Azure.
  • Nessuno. Se si specifica questo valore, la route non inoltra pacchetti.
  • VirtualAppliance. Un'appliance virtuale aggiunta alla rete virtuale di Azure.
  • VirtualNetworkGateway. Un gateway di rete privata virtuale da server a server di Azure.
  • VnetLocal. Rete virtuale locale. Se sono presenti due subnet, 10.1.0.0/16 e 10.2.0.0/16 nella stessa rete virtuale, selezionare il valore VnetLocal per ogni subnet da inoltrare all'altra subnet.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-RouteTable

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

Proprietà dei parametri

Tipo:PSRouteTable
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

PSRouteTable

String

Output

PSRouteTable