New-AzApplicationGatewayPathRuleConfig

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

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

構文

New-AzApplicationGatewayPathRuleConfig
   -Name <String>
   -Paths <String[]>
   [-BackendAddressPoolId <String>]
   [-BackendHttpSettingsId <String>]
   [-RewriteRuleSetId <String>]
   [-RedirectConfigurationId <String>]
   [-FirewallPolicyId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzApplicationGatewayPathRuleConfig
   -Name <String>
   -Paths <String[]>
   [-BackendAddressPool <PSApplicationGatewayBackendAddressPool>]
   [-BackendHttpSettings <PSApplicationGatewayBackendHttpSettings>]
   [-RewriteRuleSet <PSApplicationGatewayRewriteRuleSet>]
   [-RedirectConfiguration <PSApplicationGatewayRedirectConfiguration>]
   [-FirewallPolicy <PSApplicationGatewayWebApplicationFirewallPolicy>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

説明

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

例

例 1

$Gateway = Get-AzApplicationGateway -Name "ContosoApplicationGateway"
$AddressPool = New-AzApplicationGatewayBackendAddressPool -Name "ContosoAddressPool" -BackendIPAddresses "192.168.1.1", "192.168.1.2"
$HttpSettings = New-AzApplicationGatewayBackendHttpSetting -Name "ContosoHttpSettings" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled"
$PathRuleConfig = New-AzApplicationGatewayPathRuleConfig -Name "base" -Paths "/base" -BackendAddressPool $AddressPool -BackendHttpSettings $HttpSettings
Add-AzApplicationGatewayUrlPathMapConfig -ApplicationGateway $Gateway -Name "ContosoUrlPathMap" -PathRules $PathRuleConfig -DefaultBackendAddressPool $AddressPool -DefaultBackendHttpSettings $HttpSettings

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

例 2

$PathRuleConfig = New-AzApplicationGatewayPathRuleConfig -Name "base" -Paths "/base" -BackendAddressPool $AddressPool -BackendHttpSettings $HttpSettings -FirewallPolicy $firewallPolicy

これらのコマンドでは、名前が "base"、パスが "/base"、BackendAddressPool が $AddressPool、BackendHttp設定 が $Http設定、FirewallPolicy が $firewallPolicy.ngs、それらの設定に含まれる新しいパス規則が ContosoApplicationGateway に作成されます。

パラメーター

-BackendAddressPool

ゲートウェイ パス規則の構成設定に追加するバックエンド アドレス プール設定のコレクションへのオブジェクト参照を指定します。 このオブジェクト参照は、New-AzApplicationGatewayBackendAddressPool コマンドレットと次のような構文を使用して作成できます。$AddressPool = New-AzApplicationGatewayBackendAddressPool -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-AzApplicationGatewayBackendAddressPool コマンドレットを使用して返すことができます。 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-AzApplicationGatewayBackendHttp設定 コマンドレットと次のような構文を使用します。$Http設定 = New-AzApplicationGatewayBackendHttp設定 -Name "ContosoHttp設定" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled" 結果の変数$Http設定をパラメーター値として使用できます。DefaultBackendAddressPool パラメーター: -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-AzApplicationGatewayBackendHttp設定 コマンドレットを使用して返すことができます。 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:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FirewallPolicy

最上位レベルのファイアウォール ポリシーへのオブジェクト参照を指定します。 オブジェクト参照は、New-AzApplicationGatewayWebApplicationFirewallPolicy コマンドレットを使用して作成できます。 $firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name "wafPolicy1" -ResourceGroup "rgName" 上記のコマンドレットを使用して作成されたファイアウォール ポリシーは、パス ルール レベルで参照できます。 上記のコマンドを実行すると、既定のポリシー設定と管理ルールが作成されます。 既定値の代わりに、ユーザーは、それぞれ New-AzApplicationGatewayFirewallPolicy設定 と New-AzApplicationGatewayFirewallPolicyManagedRules を使用して、Policy設定、ManagedRules を指定できます。

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

-FirewallPolicyId

既存のトップレベル Web アプリケーション ファイアウォール リソースの ID を指定します。 ファイアウォール ポリシー ID は、Get-AzApplicationGatewayWebApplicationFirewallPolicy コマンドレットを使用して返すことができます。 ID を取得したら、FirewallPolicy パラメーターの代わりに FirewallPolicyId パラメーターを使用できます。 例: -FirewallPolicyId /subscriptions/<subscription-id>/resourceGroups/<resource-group-id>/providers/Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies/<firewallPolicyName>

Type:String
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: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

-RewriteRuleSet

Application gateway RewriteRuleSet

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

-RewriteRuleSetId

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

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

入力

None

出力

PSApplicationGatewayPathRule