次の方法で共有


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

入力

PSRouteTable

String

出力

PSRouteTable