共用方式為

Set-AzureRoute

  • 參考
模組:
Azure

在路由表中建立路由。

注意

本文件中參考的 Cmdlet 用於管理使用 Azure Service Manager（ASM） API 的舊版 Azure 資源。 建立新的資源時，不建議使用此舊版 PowerShell 模組，因為 ASM 已排定淘汰。 如需詳細資訊，請參閱 Azure Service Manager 淘汰。

Az PowerShell 模組是使用 PowerShell 管理 Azure Resource Manager （ARM） 資源的建議 PowerShell 模組。

語法

Set-AzureRoute
   -RouteName <String>
   -AddressPrefix <String>
   -NextHopType <String>
   [-NextHopIpAddress <String>]
   -RouteTable <IRouteTable>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

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：新增因特網下一個躍點路由

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 的路由，這是因特網下一個躍點類型。 命令會指定路由的位址前置詞。

參數

-AddressPrefix

指定新路由的位址前置詞。

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

-NextHopIpAddress

指定設備 IP 位址，這是使用此路由之流量的下一個躍點。 只有在您為 NextHopType 參數指定 VirtualAppliance 的值時，才指定此值。

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

-NextHopType

指定使用此路由之流量的下一個躍點類型。 有效值為：

  • VPNGateway
  • VNETLocal
  • 網際網路
  • 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