New-AzRouteConfig

  • リファレンス
モジュール:
Az.Network

ルート テーブルのルートを作成します。

構文

New-AzRouteConfig
   [-Name <String>]
   [-AddressPrefix <String>]
   [-NextHopType <String>]
   [-NextHopIpAddress <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

New-AzRouteConfig コマンドレットは、Azure ルート テーブルのルートを作成します。

例

例 1: ルートを作成する

$Route = New-AzRouteConfig -Name "Route07" -AddressPrefix 10.1.0.0/16 -NextHopType "VnetLocal"
$Route

Name              : Route07
Id                : 
Etag              : 
ProvisioningState : 
AddressPrefix     : 10.1.0.0/16
NextHopType       : VnetLocal
NextHopIpAddress  :

最初のコマンドは Route07 という名前のルートを作成し、$Route変数に格納します。 このルートは、パケットをローカル仮想ネットワークに転送します。 2 番目のコマンドは、ルートのプロパティを表示します。

例 2

ルート テーブルのルートを作成します。 (自動生成)

New-AzRouteConfig -AddressPrefix 10.1.0.0/16 -Name 'Route07' -NextHopIpAddress '12.0.0.5' -NextHopType 'VnetLocal'

例 3: サービス タグを使用してルートを作成する

New-AzRouteConfig -Name "Route07" -AddressPrefix "AppService" -NextHopType "VirtualAppliance" -NextHopIpAddress "10.0.2.4"

このコマンドは、AppService Service タグに含まれる IP プレフィックスにトラフィックを仮想アプライアンスに転送する Route07 という名前のルートを作成します。

パラメーター

-AddressPrefix

ルートが適用される宛先を クラスレス ドメイン間ルーティング (CIDR) 形式で指定します。 ここでサービス タグを指定することもできます (この機能はパブリック プレビュー段階です)。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

ルートの名前を指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NextHopIpAddress

Azurevirtual ネットワークに追加する仮想アプライアンスの IP アドレスを指定します。 このルートは、そのアドレスにパケットを転送します。 このパラメーターは、NextHopType パラメーターに VirtualAppliance の値を指定する 場合にのみ指定 します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-NextHopType

このルートがパケットを転送する方法を指定します。 このパラメーターの有効値は、次のとおりです。

  • インターネット。 Azure によって提供される既定のインターネット ゲートウェイ。
  • なし。 この値を指定した場合、ルートはパケットを転送しません。
  • VirtualAppliance。 Azure 仮想ネットワークに追加する仮想アプライアンス。
  • VirtualNetworkGateway。 Azure サーバー間仮想プライベート ネットワーク ゲートウェイ。
  • VnetLocal。 ローカル仮想ネットワーク。 同じ仮想ネットワークに 10.1.0.0/16 と 10.2.0.0/16 の 2 つのサブネットがある場合は、他のサブネットに転送するサブネットごとに VnetLocal の値を選択します。
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

String

出力

PSRoute