New-AzureRmApplicationGatewayPathRuleConfig

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

アプリケーション ゲートウェイ パス規則を作成します。

警告

AzureRM PowerShell モジュールは、2024 年 2 月 29 日の時点で正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。

AzureRM モジュールは引き続き機能する可能性がありますが、メインが維持またはサポートされなくなり、ユーザーの判断とリスクで引き続き使用できます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。

構文

New-AzureRmApplicationGatewayPathRuleConfig
   -Name <String>
   -Paths <System.Collections.Generic.List`1[System.String]>
   [-BackendAddressPoolId <String>]
   [-BackendHttpSettingsId <String>]
   [-RedirectConfigurationId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzureRmApplicationGatewayPathRuleConfig
   -Name <String>
   -Paths <System.Collections.Generic.List`1[System.String]>
   [-BackendAddressPool <PSApplicationGatewayBackendAddressPool>]
   [-BackendHttpSettings <PSApplicationGatewayBackendHttpSettings>]
   [-RedirectConfiguration <PSApplicationGatewayRedirectConfiguration>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

説明

New-AzureRmApplicationGatewayPathRuleConfig コマンドレットは、アプリケーション ゲートウェイ パス規則を作成します。 このコマンドレットによって作成された規則は、URL パス マップ構成設定のコレクションに追加し、ゲートウェイに割り当てることができます。 パス マップの構成設定は、アプリケーション ゲートウェイの負荷分散で使用されます。

例

例 1

PS C:\>$Gateway = Get-AzureRmApplicationGateway -Name "ContosoApplicationGateway"
PS C:\> $AddressPool = New-AzureRmApplicationGatewayBackendAddressPool -Name "ContosoAddressPool" -BackendIPAddresses "192.168.1.1", "192.168.1.2"
PS C:\> $HttpSettings = New-AzureRmApplicationGatewayBackendHttpSettings -Name "ContosoHttpSetings" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled"
PS C:\> $PathRuleConfig = New-AzureRmApplicationGatewayPathRuleConfig -Name "base" -Paths "/base" -BackendAddressPool $AddressPool -BackendHttpSettings $HttpSettings
PS C:\> Add-AzureRmApplicationGatewayUrlPathMapConfig -ApplicationGateway $Gateway -Name "ContosoUrlPathMap" -PathRules $PathRuleConfig -DefaultBackendAddressPool $AddressPool -DefaultBackendHttpSettings $HttpSettings

これらのコマンドは、新しいアプリケーション ゲートウェイ パス規則を作成し、Add-AzureRmApplicationGatewayUrlPathMapConfig コマンドレットを使用してその規則をアプリケーション ゲートウェイに割り当てます。 これを行うために、最初のコマンドはゲートウェイ ContosoApplicationGateway へのオブジェクト参照を作成します。 このオブジェクト参照は、$Gatewayという名前の変数に格納されます。 次の 2 つのコマンドは、バックエンド アドレス プールとバックエンド HTTP 設定オブジェクトを作成します。パス ルール オブジェクトを作成するには、これらのオブジェクト (変数$AddressPoolおよび$Http設定に格納) が必要です。 4 番目のコマンドは、パス ルール オブジェクトを作成し、$PathRuleConfigという名前の変数に格納します。 5 番目のコマンドでは、Add-AzureRmApplicationGatewayUrlPathMapConfig を使用して、構成設定と、それらの設定に含まれる新しいパス 規則を ContosoApplicationGateway に追加します。

パラメーター

-BackendAddressPool

ゲートウェイ パス規則の構成設定に追加するバックエンド アドレス プール設定のコレクションへのオブジェクト参照を指定します。 このオブジェクト参照は、New-AzureRmApplicationGatewayBackendAddressPool コマンドレットと次のような構文を使用して作成できます。$AddressPool = New-AzureRmApplicationGatewayBackendAddressPool -Name "ContosoAddressPool" -BackendIPAddresses "192.168.1.1", "192.168.1.2" 上記のコマンドは、2 つの IP アドレス (192.16.1.1 と 192.168.1.2) をアドレス プールに追加します。 IP アドレスは引用符で囲み、コンマで区切られます。 結果の変数$AddressPool、DefaultBackendAddressPool パラメーターのパラメーター値として使用できます。 バックエンド アドレス プールは、バックエンド サーバー上の IP アドレスを表します。 これらの IP アドレスは、仮想ネットワーク サブネットに属しているか、パブリック IP アドレスである必要があります。 このパラメーターを使用する場合は、同じコマンドで DefaultBackendAddressPoolId パラメーターを使用することはできません。

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

-BackendAddressPoolId

ゲートウェイ パス規則の構成設定に追加できる既存のバックエンド アドレス プールの ID を指定します。 アドレス プール ID は、Get-AzureRmApplicationGatewayBackendAddressPool コマンドレットを使用して返すことができます。 ID を取得したら、DefaultBackendAddressPool パラメーターの代わりに DefaultBackendAddressPoolId パラメーターを使用できます。 例: -DefaultBackendAddressPoolId "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendAddressPools/ContosoAddressPools" バックエンド アドレス プールは、バックエンド サーバー上の IP アドレスを表します。 これらの IP アドレスは、仮想ネットワーク サブネットに属しているか、パブリック IP アドレスである必要があります。

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

-BackendHttpSettings

ゲートウェイ パス規則の構成設定に追加するバックエンド HTTP 設定のコレクションへのオブジェクト参照を指定します。 このオブジェクト参照は、New-AzureRmApplicationGatewayBackendHttp設定 コマンドレットと次のような構文を使用して作成できます。 $Http設定 = New-AzureRmApplicationGatewayBackendHttp設定 -Name "ContosoHttpSetings" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled" 結果の変数$Http設定は、DefaultBackendAddressPool のパラメーター値として使用できます。parameter: -DefaultBackendHttp設定 $Http設定 バックエンド HTTP 設定は、バックエンド プールのポート、プロトコル、Cookie ベースのアフィニティなどのプロパティを構成します。 このパラメーターを使用する場合は、同じコマンドで DefaultBackendHttp設定Id パラメーターを使用することはできません。

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

-BackendHttpSettingsId

ゲートウェイ パス規則の構成設定に追加できる既存のバックエンド HTTP 設定コレクションの ID を指定します。 HTTP 設定 ID は、Get-AzureRmApplicationGatewayBackendHttp設定 コマンドレットを使用して返すことができます。 ID を取得したら、DefaultBackendHttp設定Id パラメーターの代わりに DefaultBackendHttp設定 パラメーターを使用できます。 例: -DefaultBackend設定 Id "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10 /resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendHttp設定Collection/ContosoHttp設定" バックエンド HTTP 設定は、ポート、プロトコル、 などのプロパティを構成します。 バックエンド プールに対する Cookie ベースのアフィニティ。 このパラメーターを使用する場合は、同じコマンドで DefaultBackendHttp設定 パラメーターを使用することはできません。

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

-DefaultProfile

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

Type:IAzureContextContainer
Aliases: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:True
Accept pipeline input:False
Accept wildcard characters:False

-Paths

1 つ以上のアプリケーション ゲートウェイ パス規則を指定します。

Type:List<T>[String]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RedirectConfiguration

Application gateway RedirectConfiguration

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

-RedirectConfigurationId

アプリケーション ゲートウェイ RedirectConfiguration の ID

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

入力

None

出力

PSApplicationGatewayPathRule