Set-AzureRoute
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.
Syntaxis
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 |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | 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 |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | 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 |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | 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 |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-RouteName
Hiermee geeft u een naam op voor de nieuwe route die door deze cmdlet wordt toegevoegd.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-RouteTable
Hiermee geeft u de routetabel aan waaraan deze cmdlet de nieuwe route toevoegt.
Type: | IRouteTable |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |