Delen via

Add-AzRouteConfig

  • Referentie
Module:
Az.Network

Hiermee voegt u een route toe aan een routetabel.

Syntaxis

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

Description

De cmdlet Add-AzRouteConfig voegt een route toe aan een Azure-routetabel.

Voorbeelden

Voorbeeld 1: Een route toevoegen aan een routetabel

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

Met de eerste opdracht wordt een routetabel met de naam RouteTable01 opgehaald met behulp van de cmdlet Get-AzRouteTable. Met de opdracht wordt de tabel opgeslagen in de variabele $RouteTable. Met de tweede opdracht wordt een route met de naam Route13 toegevoegd aan de routetabel die is opgeslagen in $RouteTable. Met deze route worden pakketten doorgestuurd naar het lokale virtuele netwerk.

Voorbeeld 2: Een route toevoegen aan een routetabel met behulp van de pijplijn

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           : []

Met deze opdracht wordt de routetabel met de naam RouteTable01 opgehaald met behulp van Get-AzRouteTable. De opdracht geeft die tabel door aan de huidige cmdlet met behulp van de pijplijnoperator. Met de huidige cmdlet wordt de route met de naam Route02 toegevoegd en wordt het resultaat vervolgens doorgegeven aan de cmdlet Set-AzRouteTable, waarmee de tabel wordt bijgewerkt om de wijzigingen weer te geven.

Voorbeeld 3: Een route met een servicetag toevoegen aan een routetabel (openbare preview)

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

Met de eerste opdracht wordt een routetabel met de naam RouteTable01 opgehaald met behulp van de cmdlet Get-AzRouteTable. Met de opdracht wordt de tabel opgeslagen in de variabele $RouteTable. Met de tweede opdracht wordt een route met de naam Route13 toegevoegd aan de routetabel die is opgeslagen in $RouteTable. Met deze route wordt verkeer doorgestuurd naar IP-voorvoegsels in de AppService Service-tag naar een virtueel apparaat.

Parameters

-AddressPrefix

Hiermee geeft u de bestemming in cidr-indeling (Classless Interdomain Routing) op waarop de route van toepassing is. U kunt hier ook een servicetag opgeven (deze functie is beschikbaar als openbare preview).

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u een naam op van de route die moet worden toegevoegd aan de routetabel.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-NextHopIpAddress

Hiermee geeft u het IP-adres op van een virtueel apparaat dat u aan uw virtuele Azure-netwerk toevoegt. Met deze route worden pakketten doorgestuurd naar dat adres. Geef deze parameter alleen op als u een waarde van VirtualAppliance opgeeft voor de parameter NextHopType.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-NextHopType

Hiermee geeft u op hoe deze route pakketten doorstuurt. De acceptabele waarden voor deze parameter zijn:

  • Internet. De standaardinternetgateway die wordt geleverd door Azure.
  • Geen. Als u deze waarde opgeeft, stuurt de route geen pakketten door.
  • VirtualAppliance. Een virtueel apparaat dat u toevoegt aan uw virtuele Azure-netwerk.
  • VirtualNetworkGateway. Een azure-server-naar-server-gateway voor een virtueel particulier netwerk.
  • VnetLocal. Het lokale virtuele netwerk. Als u twee subnetten hebt, 10.1.0.0/16 en 10.2.0.0/16 in hetzelfde virtuele netwerk, selecteert u een waarde van VnetLocal voor elk subnet om door te sturen naar het andere subnet.
Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-RouteTable

Hiermee geeft u de routetabel waaraan deze cmdlet een route toevoegt.

Type:PSRouteTable
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

PSRouteTable

String

Uitvoerwaarden

PSRouteTable