Add-AzRouteConfig
ルート テーブルにルートを追加します。
構文
Add-AzRouteConfig
-RouteTable <PSRouteTable>
[-Name <String>]
[-AddressPrefix <String>]
[-NextHopType <String>]
[-NextHopIpAddress <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
Add-AzRouteConfig コマンドレットは、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 コマンドレットを使用して RouteTable01 という名前のルート テーブルを取得します。 このコマンドは、テーブルを $RouteTable 変数に格納します。 2 番目のコマンドは、$RouteTableに格納されているルート テーブルに Route13 という名前のルートを追加します。 このルートは、パケットをローカル仮想ネットワークに転送します。
例 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 という名前のルート テーブルを取得します。 このコマンドは、パイプライン演算子を使用して、そのテーブルを現在のコマンドレットに渡します。 現在のコマンドレットは、Route02 という名前のルートを追加し、結果を Set-AzRouteTable コマンドレットに渡します。これにより、変更を反映するようにテーブルが更新されます。
例 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 コマンドレットを使用して RouteTable01 という名前のルート テーブルを取得します。 このコマンドは、テーブルを $RouteTable 変数に格納します。 2 番目のコマンドは、$RouteTableに格納されているルート テーブルに Route13 という名前のルートを追加します。 このルートは、AppService Service タグに含まれる IP プレフィックスへのトラフィックを仮想アプライアンスに転送します。
パラメーター
-AddressPrefix
ルートが適用される宛先を クラスレス ドメイン間ルーティング (CIDR) 形式で指定します。 ここでサービス タグを指定することもできます (この機能はパブリック プレビュー段階です)。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
| 型: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Name
ルート テーブルに追加するルートの名前を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-NextHopIpAddress
Azure 仮想ネットワークに追加する仮想アプライアンスの IP アドレスを指定します。 このルートは、そのアドレスにパケットを転送します。 このパラメーターは、 NextHopType パラメーターに VirtualAppliance の値を指定する場合にのみ指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-NextHopType
このルートがパケットを転送する方法を指定します。 このパラメーターの有効値は、次のとおりです。
- インターネット。 Azure によって提供される既定のインターネット ゲートウェイ。
- なし。 この値を指定した場合、ルートはパケットを転送しません。
- VirtualAppliance。 Azure 仮想ネットワークに追加する仮想アプライアンス。
- VirtualNetworkGateway。 Azure サーバー間仮想プライベート ネットワーク ゲートウェイ。
- VnetLocal。 ローカル仮想ネットワーク。 同じ仮想ネットワークに 10.1.0.0/16 と 10.2.0.0/16 の 2 つのサブネットがある場合は、他のサブネットに転送するサブネットごとに VnetLocal の値を選択します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-RouteTable
このコマンドレットがルートを追加するルート テーブルを指定します。
| 型: | PSRouteTable |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |