通过

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

Set-AzureRmRouteConfig

  • 参考
模块:
AzureRM.Network

设置路由的目标状态。

警告

截至 2024 年 2 月 29 日，AzureRM PowerShell 模块已正式弃用。 为了确保持续获得支持和更新，建议用户从 AzureRM 迁移到 Az PowerShell 模块。

尽管 AzureRM 模块仍可能正常运行，但它不再维护或受支持，但会根据用户的自由裁量权和风险继续使用任何继续使用模块。 有关过渡到 Az 模块的指导，请参阅我们的迁移资源。

语法

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

说明

Set-AzureRmRouteConfig cmdlet 设置 Azure 路由的目标状态。

示例

示例 1：修改路由

PS C:\>Get-AzureRmRouteTable -ResourceGroupName "ResourceGroup11" -Name "RouteTable01" | Set-AzureRmRouteConfig -Name "Route02" -AddressPrefix 10.4.0.0/16 -NextHopType VnetLocal | Set-AzureRmRouteTable
Name              : Routetable01
ResourceGroupName : ResourceGroup11
Location          : eastus
Id                : /subscriptions/xxxx-xxxx-xxxx-xxxx/resourceGroups/ResourceGroup11/providers/Microsoft.Networ
                    k/routeTables/RouteTable01
Etag              : W/"58c2922e-9efe-4554-a457-956ef44bc718"
ProvisioningState : Succeeded
Tags              : 
Routes            : [
                      {
                        "Name": "Route07",
                        "Etag": "W/\"58c2922e-9efe-4554-a457-956ef44bc718\"",
                        "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/\"58c2922e-9efe-4554-a457-956ef44bc718\"",
                        "Id": "/subscriptions/xxxx-xxxx-xxxx-xxxx/resourceGroups/ResourceGroup11/providers/Micro
                    soft.Network/routeTables/routetable01/routes/route02",
                        "AddressPrefix": "10.4.0.0/16",
                        "NextHopType": "VnetLocal",
                        "NextHopIpAddress": null, 
                        "ProvisioningState": "Succeeded"
                      }
                    ] 
Subnets           : []

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

参数

-AddressPrefix

以无类别域际路由选择（CIDR）格式指定路由应用到的目标。

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

-Confirm

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

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

-DefaultProfile

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

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

-Name

指定此 cmdlet 修改的路由的名称。

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

-NextHopIpAddress

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

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

-NextHopType

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

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

-RouteTable

指定与此路由关联的路由表。

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

-WhatIf

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

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

输入

PSRouteTable

String

输出

PSRouteTable