Delen via

Set-AzureRoute

  • Referentie
Module:
Azure

Hiermee maakt u een route in een routetabel.

Notitie

De cmdlets waarnaar in deze documentatie wordt verwezen, zijn bedoeld voor het beheren van verouderde Azure-resources die gebruikmaken van ASM-API's (Azure Service Manager). Deze verouderde PowerShell-module wordt niet aanbevolen bij het maken van nieuwe resources, omdat ASM is gepland voor buitengebruikstelling. Zie Buitengebruikstelling van Azure Service Manager voor meer informatie.

De Az PowerShell-module is de aanbevolen PowerShell-module voor het beheren van ARM-resources (Azure Resource Manager) met PowerShell.

Syntax

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

Description

Met de set-AzureRoute-cmdlet maakt u een route in een routetabel. De nieuwe route wordt bijna onmiddellijk van kracht op de virtuele machines die zijn gekoppeld aan de routetabel.

Voorbeelden

Voorbeeld 1: Een volgende hoproute voor een virtueel apparaat toevoegen

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

Met deze opdracht maakt u een routetabel met de naam ApplianceRouteTable op de opgegeven locatie. De opdracht geeft die routetabel door aan de huidige cmdlet. Met de huidige cmdlet wordt een route met de naam ApplianceRoute03 toegevoegd. Dit is een volgend hoptype virtualAppliance. Met de opdracht geeft u het IP-adres van de volgende hop en het adresvoorvoegsel voor de route op.

Voorbeeld 2: Een volgende hoproute voor internet toevoegen

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

Met deze opdracht wordt een routetabel met de naam ApplianceRouteTable opgehaald. De opdracht geeft die routetabel door aan de huidige cmdlet. Met de huidige cmdlet wordt een route met de naam InternetRoute toegevoegd. Dit is een volgend hoptype voor internet. Met de opdracht geeft u het adresvoorvoegsel voor de route op.

Parameters

-AddressPrefix

Hiermee geeft u een adresvoorvoegsel voor de nieuwe route.

Type:String
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:False
Accept wildcard characters:False

-NextHopIpAddress

Hiermee geeft u het IP-adres op van het apparaat dat de volgende hop is voor verkeer dat deze route gebruikt. Geef deze waarde alleen op als u een waarde van VirtualAppliance opgeeft voor de parameter NextHopType .

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-NextHopType

Hiermee geeft u het volgende hoptype voor verkeer dat deze route gebruikt. Geldige waarden zijn:

  • VPNGateway
  • VNETLocal
  • Internet
  • VirtualAppliance
  • Null
Type:String
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:False
Accept wildcard characters:False

-Profile

Hiermee geeft u het Azure-profiel op waaruit deze cmdlet wordt gelezen. Als u geen profiel opgeeft, leest deze cmdlet uit het lokale standaardprofiel.

Type:AzureSMProfile
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-RouteName

Hiermee geeft u een naam op voor de nieuwe route die door deze cmdlet wordt toegevoegd.

Type:String
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:False
Accept wildcard characters:False

-RouteTable

Hiermee geeft u de routetabel aan waaraan deze cmdlet de nieuwe route toevoegt.

Type:IRouteTable
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:False