通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

New-AzureRmApplicationGatewayPathRuleConfig

  • 参考
模块:
AzureRM.Network

创建应用程序网关路径规则。

警告

截至 2024 年 2 月 29 日，AzureRM PowerShell 模块已正式弃用。 为了确保持续获得支持和更新，建议用户从 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 cmdlet 创建应用程序网关路径规则。 此 cmdlet 创建的规则可以添加到 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 cmdlet 将该规则分配给应用程序网关。 为此，第一个命令创建对网关 ContosoApplicationGateway 的对象引用。 此对象引用存储在名为$Gateway的变量中。 接下来的两个命令创建后端地址池和后端 HTTP 设置对象;为了创建路径规则对象，需要这些对象（存储在变量$AddressPool和$Http设置中）。 第四个命令创建路径规则对象，并存储在名为$PathRuleConfig的变量中。 第五个命令使用 Add-AzureRmApplicationGatewayUrlPathMapConfig 将配置设置和包含在这些设置中的新路径规则添加到 ContosoApplicationGateway。

参数

-BackendAddressPool

指定要添加到网关路径规则配置设置的后端地址池设置集合的对象引用。 可以使用 New-AzureRmApplicationGatewayBackendAddressPool cmdlet 和如下所示的语法来创建此对象引用：$AddressPool = New-AzureRmApplicationGatewayBackendAddressPool -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 参数。

类型:PSApplicationGatewayBackendAddressPool
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-BackendAddressPoolId

指定可以添加到网关路径规则配置设置的现有后端地址池的 ID。 可以使用 Get-AzureRmApplicationGatewayBackendAddressPool 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 地址。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-BackendHttpSettings

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

类型:PSApplicationGatewayBackendHttpSettings
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-BackendHttpSettingsId

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

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DefaultProfile

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

类型:IAzureContextContainer
别名:AzureRmContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Name

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

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Paths

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

类型:List<T>[String]
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-RedirectConfiguration

应用程序网关 RedirectConfiguration

类型:PSApplicationGatewayRedirectConfiguration
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-RedirectConfigurationId

应用程序网关 RedirectConfiguration 的 ID

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

None

输出

PSApplicationGatewayPathRule