次の方法で共有

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および$HttpSettingsに格納されている)が必要です。 4 番目のコマンドは、パス ルール オブジェクトを作成し、$PathRuleConfigという名前の変数に格納します。 5 番目のコマンドでは、 Add-AzApplicationGatewayUrlPathMapConfig を使用して、構成設定とそれらの設定に含まれる新しいパス規則を ContosoApplicationGateway に追加します。

例 2

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

これらのコマンドでは、名前が "base"、パスが "/base"、BackendAddressPool が $AddressPool、BackendHttpSettings が $HttpSettings、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 パラメーターを使用することはできません。

型:PSApplicationGatewayBackendAddressPool
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る: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 アドレスである必要があります。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-BackendHttpSettings

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

型:PSApplicationGatewayBackendHttpSettings
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-BackendHttpSettingsId

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DefaultProfile

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

型:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-FirewallPolicy

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

型:PSApplicationGatewayWebApplicationFirewallPolicy
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-FirewallPolicyId

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Name

このコマンドレットが作成するパス規則の構成の名前を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Paths

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

型:String[]
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RedirectConfiguration

Application gateway RedirectConfiguration

型:PSApplicationGatewayRedirectConfiguration
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RedirectConfigurationId

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RewriteRuleSet

Application gateway RewriteRuleSet

型:PSApplicationGatewayRewriteRuleSet
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RewriteRuleSetId

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

None

出力

PSApplicationGatewayPathRule