Add-AzRouteConfig

  • Referentie
Module:
Az.Network

Hiermee voegt u een route toe aan een routetabel.

Syntax

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. De huidige cmdlet voegt de route met de naam Route02 toe en geeft vervolgens het resultaat door aan de set-AzRouteTable-cmdlet , waarmee de tabel wordt bijgewerkt om uw 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
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-NextHopType

Hiermee geeft u op hoe deze route pakketten doorstuurt. De aanvaardbare 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
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-RouteTable

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

Type:PSRouteTable
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

PSRouteTable

String

Uitvoerwaarden

PSRouteTable