Add-AzureRmRouteConfig

  • Referenz
Modul:
AzureRM.Network

Fügt einer Routingtabelle Routen hinzu.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Syntax

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

Beschreibung

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

Beispiele

Beispiel 1: Hinzufügen einer Route zu einer Routentabelle

PS C:\>$RouteTable = Get-AzureRmRouteTable -ResourceGroupName "ResourceGroup11" -Name "RouteTable01"
PS C:\> Add-AzureRmRouteConfig -Name "Route13" -AddressPrefix 10.3.0.0/16 -NextHopType "VnetLocal" -RouteTable $RouteTable

Der erste Befehl ruft mithilfe des Cmdlets Get-AzureRmRouteTable eine Routentabelle namens RouteTable01 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

PS C:\>Get-AzureRmRouteTable -ResourceGroupName "ResourceGroup11" -Name "RouteTable01" | Add-AzureRmRouteConfig -Name "Route02" -AddressPrefix 10.2.0.0/16 -NextHopType VnetLocal | Set-AzureRmRouteTable
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-AzureRmRouteTable" 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-AzureRmRouteTable , das die Tabelle aktualisiert, um Ihre Änderungen widerzuspiegeln.

Parameter

-AddressPrefix

Gibt das Ziel im klassenloses domänenübergreifendes Routing (CIDR)-Format an, auf das die Route angewendet wird.

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

-Confirm

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

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

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

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

-NextHopIpAddress

Gibt die IP-Adresse eines virtuellen Anwendung 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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 Anwendung, 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.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-RouteTable

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

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

-WhatIf

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

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

Eingaben

PSRouteTable

String

Ausgaben

PSRouteTable