共用方式為

Add-AzRouteConfig

  • 參考
模組:
Az.Network

新增路由至路由表。

語法

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 Service 標籤中包含的 IP 前置詞至虛擬設備。

參數

-AddressPrefix

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

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-DefaultProfile

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

類型:IAzureContextContainer
別名:AzContext, AzureRmContext, AzureCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Name

指定要新增至路由表的路由名稱。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-NextHopIpAddress

指定您新增至 Azure 虛擬網路之虛擬裝置的 IP 位址。 此路由會將封包轉送至該位址。 只有在您為 NextHopType 參數指定 VirtualAppliance 的值時，才指定此參數。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-NextHopType

指定此路由如何轉送封包。 此參數可接受的值為：

  • 網際網路。 Azure 提供的預設因特網閘道。
  • 無。 如果您指定此值，路由不會轉送封包。
  • VirtualAppliance。 您新增至 Azure 虛擬網路的虛擬設備。
  • VirtualNetworkGateway。 Azure 伺服器對伺服器虛擬專用網閘道。
  • VnetLocal。 本機虛擬網路。 如果您有兩個子網，即相同虛擬網路中的 10.1.0.0/16 和 10.2.0.0/16，請為每個子網選取 VnetLocal 的值，以轉送至其他子網。
類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-RouteTable

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

類型:PSRouteTable
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

類型:SwitchParameter
別名:wi
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

PSRouteTable

String

輸出

PSRouteTable