Set-AzureRoute
ルート テーブルにルートを作成します。
Note
このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用するレガシ Azure リソースを管理するためのものです。 ASM の廃止が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、「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>]
説明
Set-AzureRoute コマンドレットは 、 ルート テーブルにルートを作成します。 新しいルートは、ルート テーブルに関連付けられている仮想マシンでほぼ即座に有効になります。
例
例 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 という名前のルート テーブルを作成します。 このコマンドは、そのルート テーブルを現在のコマンドレットに渡します。 現在のコマンドレットは、VirtualAppliance の次ホップの種類である ApplianceRoute03 という名前のルートを追加します。 このコマンドは、ルートの次ホップ 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 という名前のルート テーブルを取得します。 このコマンドは、そのルート テーブルを現在のコマンドレットに渡します。 現在のコマンドレットは、InternetRoute という名前のルートを追加します。これはインターネット の次ホップの種類です。 このコマンドは、ルートのアドレス プレフィックスを指定します。
パラメーター
-AddressPrefix
新しいルートのアドレス プレフィックスを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-NextHopIpAddress
このルートを使用するトラフィックの次ホップであるアプライアンスの IP アドレスを指定します。 この値は、NextHopType パラメーターに VirtualAppliance の値を指定する 場合にのみ指定 します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-NextHopType
このルートを使用するトラフィックの次ホップの種類を指定します。 有効な値は次のとおりです。
- VPNGateway
- VNETLocal
- インターネット
- VirtualAppliance
- [Null]
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Profile
このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。
型: | AzureSMProfile |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-RouteName
このコマンドレットが追加する新しいルートの名前を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-RouteTable
このコマンドレットが新しいルートを追加するルート テーブルを指定します。
型: | IRouteTable |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |