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

New-AzRouteConfig

为路由表创建路由。

语法

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

说明

New-AzRouteConfig cmdlet 为 Azure 路由表创建路由。

示例

示例 1:创建路由

$Route = New-AzRouteConfig -Name "Route07" -AddressPrefix 10.1.0.0/16 -NextHopType "VnetLocal"
$Route

Name              : Route07
Id                : 
Etag              : 
ProvisioningState : 
AddressPrefix     : 10.1.0.0/16
NextHopType       : VnetLocal
NextHopIpAddress  :

第一个命令创建名为 Route07 的路由,然后将其存储在$Route变量中。 此路由将数据包转发到本地虚拟网络。 第二个命令显示路由的属性。

示例 2

为路由表创建路由。 (自动生成)

New-AzRouteConfig -AddressPrefix 10.1.0.0/16 -Name 'Route07' -NextHopIpAddress '12.0.0.5' -NextHopType 'VnetLocal'

示例 3:使用服务标记创建路由

New-AzRouteConfig -Name "Route07" -AddressPrefix "AppService" -NextHopType "VirtualAppliance" -NextHopIpAddress "10.0.2.4"

此命令将名为 Route07 的路由转发到 AppService 服务标记中包含的 IP 前缀的流量转发到虚拟设备。

参数

-AddressPrefix

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

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Confirm

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

类型:SwitchParameter
别名:cf
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DefaultProfile

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

类型:IAzureContextContainer
别名:AzContext, AzureRmContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Name

指定路由的名称。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-NextHopIpAddress

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

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-NextHopType

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

  • Internet。 Azure 提供的默认 Internet 网关。
  • 无。 如果指定此值,则路由不会转发数据包。
  • VirtualAppliance。 添加到 Azure 虚拟网络的虚拟设备。
  • VirtualNetworkGateway。 Azure 服务器到服务器虚拟专用网络网关。
  • VnetLocal。 本地虚拟网络。 如果同一虚拟网络中有两个子网,即 10.1.0.0/16 和 10.2.0.0/16,请为每个子网选择 VnetLocal 的值以转发到其他子网。
类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-WhatIf

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

类型:SwitchParameter
别名:wi
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

String

输出

PSRoute