Set-AzRouteConfig
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 |