Set-AzRouteConfig

Modul:
Az.Network Module

Aktualisiert eine Routenkonfiguration für eine Routentabelle.

Syntax

Default (Standard) 

Set-AzRouteConfig
    -RouteTable <PSRouteTable>
    [-Name <String>]
    [-AddressPrefix <String>]
    [-NextHopType <String>]
    [-NextHopIpAddress <String[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [-AcquirePolicyToken]
    [-ChangeReference <String>]
    [<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

-AcquirePolicyToken

Rufen Sie automatisch ein Azure Policy Token für diesen Ressourcenvorgang ab.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-AddressPrefix

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ChangeReference

Die Änderungsreferenzressourcen-ID für diesen Ressourcenvorgang.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Cf

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DefaultProfile

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

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

Gibt den Namen der Route an, die dieses Cmdlet ändert.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-NextHopIpAddress

Gibt die nächste Hop-IP-Adresse(n) an, an die diese Route Pakete weiterleitet. Geben Sie für einen NextHopType von VirtualAppliance eine einzelne IP-Adresse einer virtuellen Appliance an, die Sie Zu Ihrem Azure virtuellen Netzwerk hinzufügen. Geben Sie für einen NextHopType von VirtualApplianceEcmp zwischen 2 und 64 IP-Adressen an, um datenverkehrsgleich mit gleichem Kosten-Multi-Path-Routing (ECMP) zu lastenausgleichen.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-NextHopType

Gibt an, wie diese Route Pakete weiterleitet. Die zulässigen Werte für diesen Parameter sind:

  • Internet. Das von Azure bereitgestellte Standard-Internetgateway.
  • None. Wenn Sie diesen Wert angeben, leitet die Route keine Pakete weiter.
  • VirtualAppliance. Eine virtuelle Appliance, die Sie Ihrem Azure virtuellen Netzwerk hinzufügen.
  • VirtualApplianceEcmp. Mehrere virtuelle Appliances, für die datenverkehrsgelastend ist, werden mithilfe des ECMP-Routings (Equal-Cost Multi-Path) ausgeglichen. Stellen Sie die IP-Adressen der Appliance über den Parameter NextHopIpAddress bereit.
  • 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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-RouteTable

Gibt die Routentabelle an, der diese Route zugeordnet ist.

Parametereigenschaften

Typ:PSRouteTable
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-WhatIf

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

PSRouteTable

String

Ausgaben

PSRouteTable