Add-AzRouteConfig

  • Referenz
Modul:
Az.Network

Fügt einer Routingtabelle Routen hinzu.

Syntax

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

Beschreibung

Das Add-AzRouteConfig-Cmdlet fügt eine Route zu einer Azure-Routentabelle hinzu.

Beispiele

Beispiel 1: Hinzufügen einer Route zu einer Routentabelle

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

Der erste Befehl ruft eine Routentabelle namens RouteTable01 mithilfe des Cmdlets "Get-AzRouteTable" ab. Der Befehl speichert die Tabelle in der variablen $RouteTable. Mit dem zweiten Befehl wird der in $RouteTable gespeicherten Route "Route13" eine Route mit dem Namen Route13 hinzugefügt. Diese Route leitet Pakete an das lokale virtuelle Netzwerk weiter.

Beispiel 2: Hinzufügen einer Route zu einer Routentabelle mithilfe der Pipeline

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

Mit diesem Befehl wird die Routentabelle "RouteTable01" mithilfe von "Get-AzRouteTable" abgerufen. Der Befehl übergibt diese Tabelle mithilfe des Pipelineoperators an das aktuelle Cmdlet. Das aktuelle Cmdlet fügt die Route mit dem Namen Route02 hinzu und übergibt dann das Ergebnis an das Cmdlet Set-AzRouteTable , das die Tabelle aktualisiert, um Ihre Änderungen widerzuspiegeln.

Beispiel 3: Hinzufügen einer Route mit einem Diensttag zu einer Routentabelle (öffentliche Vorschau)

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

Der erste Befehl ruft eine Routentabelle namens RouteTable01 mithilfe des Cmdlets "Get-AzRouteTable" ab. Der Befehl speichert die Tabelle in der variablen $RouteTable. Mit dem zweiten Befehl wird der in $RouteTable gespeicherten Route "Route13" eine Route mit dem Namen Route13 hinzugefügt. Diese Route leitet Datenverkehr an IP-Präfixe weiter, die im AppService-Diensttag enthalten sind, an eine virtuelle Appliance weiter.

Parameter

-AddressPrefix

Gibt das Ziel im klassenloses domänenübergreifendes Routing (CIDR)-Format an, auf das die Route angewendet wird. Sie können hier auch ein Diensttag angeben (dieses Feature befindet sich in der öffentlichen Vorschau).

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt einen Namen der Route an, die der Routentabelle hinzugefügt werden soll.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NextHopIpAddress

Gibt die IP-Adresse einer virtuellen Appliance an, die Sie Ihrem virtuellen Azure-Netzwerk hinzufügen. Diese Route leitet Pakete an diese Adresse weiter. Geben Sie diesen Parameter nur an, wenn Sie einen Wert von VirtualAppliance für den Parameter NextHopType angeben.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-NextHopType

Gibt an, wie diese Route Pakete weiterleitet. Zulässige Werte für diesen Parameter:

  • Internet. Das von Azure bereitgestellte Standard-Internetgateway.
  • Keine. Wenn Sie diesen Wert angeben, leitet die Route keine Pakete weiter.
  • VirtualAppliance. Eine virtuelle Appliance, die Sie Ihrem virtuellen Azure-Netzwerk hinzufügen.
  • VirtualNetworkGateway. Ein azure server-to-server virtual privates Netzwerkgateway.
  • VnetLocal. Das lokale virtuelle Netzwerk. Wenn Sie über zwei Subnetze verfügen: 10.1.0.0/16 und 10.2.0.0/16 im selben virtuellen Netzwerk, wählen Sie einen Wert von VnetLocal für jedes Subnetz aus, das an das andere Subnetz weitergeleitet werden soll.
Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-RouteTable

Gibt die Routentabelle an, der dieses Cmdlet eine Route hinzufügt.

Typ:PSRouteTable
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

PSRouteTable

String

Ausgaben

PSRouteTable