你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Set-AzureRoute
在路由表中创建路由。
注意
本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧式 Azure 资源。 创建新资源时，建议不要使用旧的 PowerShell 模块，因为计划将停用 ASM。 有关详细信息，请参阅 Azure Service Manager 停用。
Az PowerShell 模块是建议用于管理 PowerShell 的 Azure 资源管理器 (ARM) 资源的 PowerShell 模块。
语法
Set-AzureRoute
-RouteName <String>
-AddressPrefix <String>
-NextHopType <String>
[-NextHopIpAddress <String>]
-RouteTable <IRouteTable>
[-Profile <AzureSMProfile>]
[<CommonParameters>] 说明
Set-AzureRoute cmdlet 在路由表中创建路由。 新路由几乎立即在与路由表关联的虚拟机上生效。
示例
示例 1：添加虚拟设备下一跃点路由
PS C:\> New-AzureRouteTable -Name "ApplianceRouteTable" -Location "Central US" -Label "Appliance Route Table" | Set-AzureRoute -RouteName "ApplianceRoute03" -AddressPrefix "10.0.0.0/24" -NextHopType VirtualAppliance -NextHopIpAddress "10.0.1.5"
Routes Name Location Label
------ ---- -------- -----
{approute} AppRT Central US Appliance Route Table此命令在指定位置创建名为 ApplianceRouteTable 的路由表。 该命令将该路由表传递到当前 cmdlet。 当前 cmdlet 添加名为 ApplianceRoute03 的路由，这是 VirtualAppliance 下一跃点类型。 该命令指定路由的下一跃点 IP 地址和地址前缀。
示例 2：添加 Internet 下一跃点路由
PS C:\> Get-AzureRouteTable -Name "ApplianceRouteTable" | Set-AzureRoute -RouteName "InternetRoute" -AddressPrefix "0.0.0.0/0" -NextHopType Internet
Routes Name Location Label
------ ---- -------- -----
{approute, internetroute} AppRT Central US Appliance Route Table此命令获取名为 ApplianceRouteTable 的路由表。 该命令将该路由表传递到当前 cmdlet。 当前 cmdlet 添加名为 InternetRoute 的路由，这是 Internet 下一跃点类型。 该命令指定路由的地址前缀。
参数
-AddressPrefix
指定新路由的地址前缀。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-NextHopIpAddress
指定设备 IP 地址，该设备是使用此路由的流量的下一跃点。 仅当为 NextHopType 参数指定 VirtualAppliance 值时，才指定此值。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-NextHopType
指定使用此路由的流量的下一跃点类型。 有效值为：
- VPNGateway
- VNETLocal
- Internet
- VirtualAppliance
- Null
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-Profile
指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件，此 cmdlet 将从本地默认配置文件中读取。
| 类型: | AzureSMProfile |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-RouteName
指定此 cmdlet 添加的新路由的名称。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-RouteTable
指定此 cmdlet 向其添加新路由的路由表。
| 类型: | IRouteTable |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |