你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Add-AzRouteConfig

将路由添加到路由表。

语法

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

说明

Add-AzRouteConfig cmdlet 将路由添加到 Azure 路由表。

示例

示例 1:向路由表添加路由

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

第一个命令使用 Get-AzRouteTable cmdlet 获取名为 RouteTable01 的路由表。 该命令将表存储在$RouteTable变量中。 第二个命令将名为 Route13 的路由添加到存储在$RouteTable中的路由表。 此路由将数据包转发到本地虚拟网络。

示例 2:使用管道将路由添加到路由表

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

此命令使用 Get-AzRouteTable 获取名为 RouteTable01 的路由表。 该命令使用管道运算符将该表传递到当前 cmdlet。 当前 cmdlet 添加名为 Route02 的路由,然后将结果 传递给 Set-AzRouteTable cmdlet,该 cmdlet 将更新表以反映更改。

示例 3:将包含服务标记的路由添加到路由表(公共预览版)

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

第一个命令使用 Get-AzRouteTable cmdlet 获取名为 RouteTable01 的路由表。 该命令将表存储在$RouteTable变量中。 第二个命令将名为 Route13 的路由添加到存储在$RouteTable中的路由表。 此路由将流量转发到 AppService 服务标记中包含的 IP 前缀到虚拟设备。

参数

-AddressPrefix

以无类别域际路由选择(CIDR)格式指定路由应用到的目标。 还可以在此处指定服务标记(此功能为公共预览版)。

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

-Confirm

提示你在运行 cmdlet 之前进行确认。

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

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

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

-Name

指定要添加到路由表的路由的名称。

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

-NextHopIpAddress

指定添加到 Azure 虚拟网络的虚拟设备的 IP 地址。 此路由将数据包转发到该地址。 仅当为 NextHopType 参数指定 VirtualAppliance 值时,才指定此参数。

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

-NextHopType

指定此路由如何转发数据包。 此参数的可接受值为:

  • Internet。 Azure 提供的默认 Internet 网关。
  • 无。 如果指定此值,则路由不会转发数据包。
  • VirtualAppliance。 添加到 Azure 虚拟网络的虚拟设备。
  • VirtualNetworkGateway。 Azure 服务器到服务器虚拟专用网络网关。
  • VnetLocal。 本地虚拟网络。 如果同一虚拟网络中有两个子网,即 10.1.0.0/16 和 10.2.0.0/16,请为每个子网选择 VnetLocal 的值以转发到其他子网。
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-RouteTable

指定此 cmdlet 向其添加路由的路由表。

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

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

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

输入

PSRouteTable

String

输出

PSRouteTable