你当前正在访问 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 模块，用于使用 PowerShell 管理 Azure 资源管理器 （ARM） 资源。
语法
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 |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NextHopIpAddress
指定设备 IP 地址，该设备是使用此路由的流量的下一跃点。 仅当为 NextHopType 参数指定 VirtualAppliance 值时，才指定此值。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NextHopType
指定使用此路由的流量的下一跃点类型。 有效值为：
- VPNGateway
- VNETLocal
- Internet
- VirtualAppliance
- Null
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Profile
指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件，此 cmdlet 将从本地默认配置文件中读取。
| 类型: | AzureSMProfile |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RouteName
指定此 cmdlet 添加的新路由的名称。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RouteTable
指定此 cmdlet 向其添加新路由的路由表。
| 类型: | IRouteTable |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |