New-AzRouteConfig
语法
Default (默认值)
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
为路由表创建路由。 (autogenerated)
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
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-Confirm
在运行 cmdlet 之前,提示你进行确认。
参数属性
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-DefaultProfile
用于与 Azure 通信的凭据、帐户、租户和订阅。
参数属性
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Name
指定路由的名称。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-NextHopIpAddress
指定添加到 Azure 虚拟网络的虚拟设备的 IP 地址。
此路由将数据包转发到该地址。
仅当为 NextHopType 参数指定 VirtualAppliance 值时,才指定此参数。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-NextHopType
指定此路由如何转发数据包。
此参数的可接受值为:
- 互联网。
Azure 提供的默认 Internet 网关。
- 没有。
如果指定此值,则路由不会转发数据包。
- VirtualAppliance。
添加到 Azure 虚拟网络的虚拟设备。
- VirtualNetworkGateway。
Azure 服务器到服务器虚拟专用网络网关。
- VnetLocal。
本地虚拟网络。
如果同一虚拟网络中有两个子网,即 10.1.0.0/16 和 10.2.0.0/16,请为每个子网选择 VnetLocal 的值以转发到其他子网。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。
参数属性
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。
输出