New-AzApplicationGatewayPathRuleConfig

语法

SetByResourceId

New-AzApplicationGatewayPathRuleConfig
    -Name <String>
    -Paths <String[]>
    [-BackendAddressPoolId <String>]
    [-BackendHttpSettingsId <String>]
    [-RewriteRuleSetId <String>]
    [-RedirectConfigurationId <String>]
    [-FirewallPolicyId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

SetByResource

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

说明

示例

示例 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

示例 2

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

参数

-BackendAddressPool

指定要添加到网关路径规则配置设置的后端地址池设置集合的对象引用。 可以使用 New-AzApplicationGatewayBackendAddressPool cmdlet 和如下所示的语法来创建此对象引用： $AddressPool = New-AzApplicationGatewayBackendAddressPool -Name "ContosoAddressPool" -BackendIPAddresses "192.168.1.1", "192.168.1.2" 上述命令将两个 IP 地址（192.16.1.1 和 192.168.1.2）添加到地址池。 请注意，IP 地址用引号括起来，并使用逗号分隔。 然后，生成的变量$AddressPool可用作 DefaultBackendAddressPool 参数的参数值。 后端地址池表示后端服务器上的 IP 地址。 这些 IP 地址应属于虚拟网络子网，或者应该是公共 IP 地址。 如果使用此参数，则不能在同一命令中使用 DefaultBackendAddressPoolId 参数。

参数属性

参数集

-BackendAddressPoolId

指定可以添加到网关路径规则配置设置的现有后端地址池的 ID。 可以使用 Get-AzApplicationGatewayBackendAddressPool cmdlet 返回地址池 ID。 获得 ID 后，可以使用 DefaultBackendAddressPoolId 参数而不是 DefaultBackendAddressPool 参数。 例如：-DefaultBackendAddressPoolId“/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendAddressPools/ContosoAddressPool”后端地址池表示后端服务器上的 IP 地址。 这些 IP 地址应属于虚拟网络子网，或者应该是公共 IP 地址。

参数属性

参数集

-BackendHttpSettings

指定要添加到网关路径规则配置设置的后端 HTTP 设置集合的对象引用。 可以使用类似于下面的 New-AzApplicationGatewayBackendHttpSettings cmdlet 和语法来创建此对象引用：$HttpSettings = New-AzApplicationGatewayBackendHttpSettings -Name “ContosoHttpSettings” -Port 80 -Protocol “Http” -CookieBasedAffinity “Disabled” 生成的变量， 然后，$HttpSettings可用作 DefaultBackendAddressPool 参数的参数值：-DefaultBackendHttpSettings $HttpSettings 后端 HTTP 设置配置后端池的端口、协议和基于 Cookie 的相关性等属性。 如果使用此参数，则不能在同一命令中使用 DefaultBackendHttpSettingsId 参数。

参数属性

参数集

-BackendHttpSettingsId

指定可以添加到网关路径规则配置设置的现有后端 HTTP 设置集合的 ID。 可以使用 Get-AzApplicationGatewayBackendHttpSettings cmdlet 返回 HTTP 设置 ID。 获得 ID 后，可以使用 DefaultBackendHttpSettingsId 参数而不是 DefaultBackendHttpSettings 参数。 例如：-DefaultBackendSettings ID“/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendHttpSettingsCollection/ContosoHttpSettings”后端 HTTP 设置配置端口等属性， 后端池的协议和基于 Cookie 的相关性。 如果使用此参数，则不能在同一命令中使用 DefaultBackendHttpSettings 参数。

参数属性

参数集

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

参数属性

参数集

-FirewallPolicy

指定对顶级防火墙策略的对象引用。 可以使用 New-AzApplicationGatewayWebApplicationFirewallPolicy cmdlet 创建对象引用。 $firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name“wafPolicy1”-ResourceGroup“rgName”使用上述 cmdlet 创建的防火墙策略可以在路径规则级别引用。 上述命令将创建默认策略设置和托管规则。 用户可以使用 New-AzApplicationGatewayFirewallPolicySettings 和 New-AzApplicationGatewayFirewallPolicyManagedRules 来指定 PolicySettings、ManagedRules，而不是默认值。

参数属性

参数集

-FirewallPolicyId

指定现有顶级 Web 应用程序防火墙资源的 ID。 可以使用 Get-AzApplicationGatewayWebApplicationFirewallPolicy cmdlet 返回防火墙策略 ID。 获得 ID 后，可以使用 FirewallPolicyId 参数而不是 FirewallPolicy 参数。 例如：-FirewallPolicyId /subscriptions/<subscription-id>/resourceGroups/<resource-group-id>/providers/Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies/<firewallPolicyName>

参数属性

参数集

-Name

指定此 cmdlet 创建的路径规则配置的名称。

参数属性

参数集

-Paths

指定一个或多个应用程序网关路径规则。

参数属性

参数集

-RedirectConfiguration

应用程序网关 RedirectConfiguration

参数属性

参数集

-RedirectConfigurationId

应用程序网关 RedirectConfiguration 的 ID

参数属性

参数集

-RewriteRuleSet

应用程序网关 RewriteRuleSet

参数属性

参数集

-RewriteRuleSetId

应用程序网关 RewriteRuleSet 的 ID

参数属性

参数集

CommonParameters

输入

None

输出

PSApplicationGatewayPathRule

相关链接

• Add-AzApplicationGatewayUrlPathMapConfig
• Get-AzApplicationGateway
• Get-AzApplicationGatewayUrlPathMapConfig
• New-AzApplicationGatewayBackendAddressPool
• New-AzApplicationGatewayBackendHttpSetting
• New-AzApplicationGatewayPathRuleConfig
• New-AzApplicationGatewayUrlPathMapConfig
• Remove-AzApplicationGatewayUrlPathMapConfig
• Set-AzApplicationGatewayUrlPathMapConfig