Set-AzRouteConfig
Aggiorna una configurazione di route per una tabella di route.
Sintassi
Set-AzRouteConfig
-RouteTable <PSRouteTable>
[-Name <String>]
[-AddressPrefix <String>]
[-NextHopType <String>]
[-NextHopIpAddress <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Il cmdlet Set-AzRouteConfig aggiorna una configurazione di route per una tabella di route.
Esempio
Esempio 1: Modificare una route
Get-AzRouteTable -ResourceGroupName "ResourceGroup11" -Name "RouteTable01" | Set-AzRouteConfig -Name "Route02" -AddressPrefix 10.4.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/"58c2922e-9efe-4554-a457-956ef44bc718"
ProvisioningState : Succeeded
Tags :
Routes : [
{
"Name": "Route07",
"Etag": "W/\"58c2922e-9efe-4554-a457-956ef44bc718\"",
"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/\"58c2922e-9efe-4554-a457-956ef44bc718\"",
"Id": "/subscriptions/xxxx-xxxx-xxxx-xxxx/resourceGroups/ResourceGroup11/providers/Micro
soft.Network/routeTables/routetable01/routes/route02",
"AddressPrefix": "10.4.0.0/16",
"NextHopType": "VnetLocal",
"NextHopIpAddress": null,
"ProvisioningState": "Succeeded"
}
]
Subnets : []
Questo comando ottiene la tabella di route denominata RouteTable01 usando il cmdlet Get-AzRouteTable. Il comando passa tale tabella al cmdlet corrente usando l'operatore pipeline. Il cmdlet corrente modifica la route denominata Route02 e quindi passa il risultato al cmdlet Set-AzRouteTable , che aggiorna la tabella in modo da riflettere le modifiche.
Esempio 2: Modificare una route usando un tag di servizio (anteprima pubblica)
Set-AzRouteConfig -Name "Route02" -AddressPrefix "AppService" -NextHopType "VirtualAppliance" -NextHopIpAddress "10.0.2.4"
Questo comando modifica la route denominata Route02, specificando un tag di servizio come parametro AddressPrefix.
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).
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-Confirm
Richiede conferma prima di eseguire il cmdlet.
Tipo: | SwitchParameter |
Alias: | cf |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-DefaultProfile
Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.
Tipo: | IAzureContextContainer |
Alias: | AzContext, AzureRmContext, AzureCredential |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-Name
Specifica il nome della route modificata da questo cmdlet.
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | 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 .
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-NextHopType
Specifica il modo in cui questa route inoltra i pacchetti. I valori validi 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.
- 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.
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-RouteTable
Specifica la tabella di route a cui è associata la route.
Tipo: | PSRouteTable |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.
Tipo: | SwitchParameter |
Alias: | wi |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |