共用方式為

Add-AzRouteConfig

模組:
Az.Network Module

新增路由至路由表。

語法

Default (預設值) 

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

Description

Add-AzRouteConfig Cmdlet 會將路由新增至 Azure 路由表。

範例

範例 1：將路由新增至路由表

$RouteTable = Get-AzRouteTable -ResourceGroupName "ResourceGroup11" -Name "RouteTable01"
Add-AzRouteConfig -Name "Route13" -AddressPrefix 10.3.0.0/16 -NextHopType "VnetLocal" -RouteTable $RouteTable

第一個命令會使用 Get-AzRouteTable Cmdlet 取得名為 RouteTable01 的路由表。 此指令會將表格儲存在 $RouteTable 變數中。 第二個命令將名為 Route13 的路由新增至儲存在 $RouteTable 中的路由表。 此路由會將封包轉送至本機虛擬網路。

範例 2：使用管線將路由新增至路由表

Get-AzRouteTable -ResourceGroupName "ResourceGroup11" -Name "RouteTable01" | Add-AzRouteConfig -Name "Route02" -AddressPrefix 10.2.0.0/16 -NextHopType VnetLocal | Set-AzRouteTable

Name              : routetable01
ResourceGroupName : ResourceGroup11
Location          : eastus
Id                : /subscriptions/xxxx-xxxx-xxxx-xxxx/resourceGroups/ResourceGroup11/providers/Microsoft.Networ
                    k/routeTables/routetable01
Etag              : W/"f13e1bc8-d41f-44d0-882d-b8b5a1134f59"
ProvisioningState : Succeeded
Tags              :
Routes            : [
                      {
                        "Name": "route07",
                        "Etag": "W/\"f13e1bc8-d41f-44d0-882d-b8b5a1134f59\"",
                        "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/\"f13e1bc8-d41f-44d0-882d-b8b5a1134f59\"",
                        "Id": "/subscriptions/xxxx-xxxx-xxxx-xxxx/resourceGroups/ResourceGroup11/providers/Micro
                    soft.Network/routeTables/routetable01/routes/route02",
                        "AddressPrefix": "10.2.0.0/16",
                        "NextHopType": "VnetLocal",
                        "NextHopIpAddress": null,
                        "ProvisioningState": "Succeeded"
                      },
                      {
                        "Name": "route13",
                        "Etag": null,
                        "Id": null,
                        "AddressPrefix": "10.3.0.0/16",
                        "NextHopType": "VnetLocal",
                        "NextHopIpAddress": null,
                        "ProvisioningState": null
                      }
                    ]
Subnets           : []

此命令會使用 Get-AzRouteTable 取得名為 RouteTable01 的路由表。 命令會使用管線運算子將該資料表傳遞至目前的 Cmdlet。 目前的 Cmdlet 會新增名為 Route02 的路由，然後將結果傳遞至 Set-AzRouteTable Cmdlet，以更新資料表以反映您的變更。

範例 3：將具有服務標籤的路由新增至路由表 （公開預覽）

$RouteTable = Get-AzRouteTable -ResourceGroupName "ResourceGroup11" -Name "RouteTable01"
Add-AzRouteConfig -Name "Route13" -AddressPrefix "AppService" -NextHopType "VirtualAppliance" -NextHopIpAddress "10.0.2.4" -RouteTable $RouteTable

第一個命令會使用 Get-AzRouteTable Cmdlet 取得名為 RouteTable01 的路由表。 此指令會將表格儲存在 $RouteTable 變數中。 第二個命令將名為 Route13 的路由新增至儲存在 $RouteTable 中的路由表。 此路由會將流量轉送至 AppService 服務標籤中包含的 IP 前置詞，以轉送至虛擬設備。

參數

-AddressPrefix

以無類別網域間路由 （CIDR） 格式指定路由套用的目的地。 您也可以在這裡指定服務標籤 （此功能為公開預覽版）。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:參見

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

參數屬性

類型:IAzureContextContainer
預設值:None
支援萬用字元:False
不要顯示:False
別名:AzContext, AzureRmContext, AzureCredential

參數集

(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 所提供的預設網際網路閘道。
  • 沒有。 如果指定此值，則路由不會轉送資料包。
  • VirtualAppliance 的 VirtualAppliance 中。 您新增至 Azure 虛擬網路的虛擬設備。
  • VirtualNetworkGateway 的 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

-RouteTable

指定此 Cmdlet 新增路由的路由表。

參數屬性

類型:PSRouteTable
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:True
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 指令未執行。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:威斯康辛

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。

輸入

PSRouteTable

String

輸出

PSRouteTable