Set-AzRouteConfig

  • Referenz
Modul:
Az.Network

Aktualisiert eine Routenkonfiguration für eine Routentabelle.

Syntax

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

Beschreibung

Das Cmdlet Set-AzRouteConfig aktualisiert eine Routenkonfiguration für eine Routentabelle.

Beispiele

Beispiel 1: Ändern einer Route

Get-AzRouteTable -ResourceGroupName "ResourceGroup11" -Name "RouteTable01" | Set-AzRouteConfig -Name "Route02" -AddressPrefix 10.4.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/"58c2922e-9efe-4554-a457-956ef44bc718"
ProvisioningState : Succeeded
Tags              : 
Routes            : [
                      {
                        "Name": "Route07",
                        "Etag": "W/\"58c2922e-9efe-4554-a457-956ef44bc718\"",
                        "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/\"58c2922e-9efe-4554-a457-956ef44bc718\"",
                        "Id": "/subscriptions/xxxx-xxxx-xxxx-xxxx/resourceGroups/ResourceGroup11/providers/Micro
                    soft.Network/routeTables/routetable01/routes/route02",
                        "AddressPrefix": "10.4.0.0/16",
                        "NextHopType": "VnetLocal",
                        "NextHopIpAddress": null, 
                        "ProvisioningState": "Succeeded"
                      }
                    ] 
Subnets           : []

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

Beispiel 2: Ändern einer Route mithilfe eines Diensttags (öffentliche Vorschau)

Set-AzRouteConfig -Name "Route02" -AddressPrefix "AppService" -NextHopType "VirtualAppliance" -NextHopIpAddress "10.0.2.4"

Mit diesem Befehl wird die Route namens Route02 geändert, wobei ein Diensttag als AddressPrefix-Parameter bereitgestellt wird.

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 den Namen der Route an, die dieses Cmdlet ändert.

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 azureserver-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 diese Route zugeordnet ist.

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