Compartir a través de

New-AzApplicationGatewayPathRuleConfig

  • Referencia
Módulo:
Az.Network

Crea una regla de ruta de acceso de puerta de enlace de aplicaciones.

Sintaxis

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>]

Description

El cmdlet New-AzApplicationGatewayPathRuleConfig crea una regla de ruta de acceso de puerta de enlace de aplicaciones. Las reglas creadas por este cmdlet se pueden agregar a una colección de opciones de configuración del mapa de ruta de acceso url y, a continuación, asignarlas a una puerta de enlace. Las opciones de configuración del mapa de ruta de acceso se usan en el equilibrio de carga de Application Gateway.

Ejemplos

Ejemplo 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

Estos comandos crean una nueva regla de ruta de acceso de puerta de enlace de aplicaciones y, a continuación, usan el cmdlet Add-AzApplicationGatewayUrlPathMapConfig para asignar esa regla a una puerta de enlace de aplicaciones. Para ello, el primer comando crea una referencia de objeto a la puerta de enlace ContosoApplicationGateway. Esta referencia de objeto se almacena en una variable denominada $Gateway. Los dos comandos siguientes crean un grupo de direcciones de back-end y un objeto de configuración HTTP de back-end; estos objetos (almacenados en las variables $AddressPool y $HttpSettings) son necesarios para crear un objeto de regla de ruta de acceso. El cuarto comando crea el objeto de regla de ruta de acceso y se almacena en una variable denominada $PathRuleConfig. El quinto comando usa Add-AzApplicationGatewayUrlPathMapConfig para agregar las opciones de configuración y la nueva regla de ruta de acceso contenida en esas opciones a ContosoApplicationGateway.

Ejemplo 2

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

Este comando crea una regla de ruta de acceso con el nombre como "base", Rutas de acceso como "/base", BackendAddressPool como $AddressPool, BackendHttpSettings como $HttpSettings y FirewallPolicy como $firewallPolicy.ngs y la nueva regla de ruta de acceso contenida en esas opciones en ContosoApplicationGateway.

Parámetros

-BackendAddressPool

Especifica una referencia de objeto a una colección de valores de grupo de direcciones de back-end que se van a agregar a los valores de configuración de las reglas de ruta de acceso de puerta de enlace. Puede crear esta referencia de objeto mediante el cmdlet New-AzApplicationGatewayBackendAddressPool y la sintaxis similar a esta: $AddressPool = New-AzApplicationGatewayBackendAddressPool -Name "ContosoAddressPool" -BackendIPAddresses "192.168.1.1", "192.168.1.2" El comando anterior agrega dos direcciones IP (192.16.1.1 y 192.168.1.2) al grupo de direcciones. Tenga en cuenta que la dirección IP se incluye entre comillas y se separa mediante comas. La variable resultante, $AddressPool, se puede usar como valor de parámetro para el parámetro DefaultBackendAddressPool . El grupo de direcciones de back-end representa las direcciones IP en los servidores back-end. Estas direcciones IP deben pertenecer a la subred de red virtual o deben ser direcciones IP públicas. Si usa este parámetro, no puede usar el parámetro DefaultBackendAddressPoolId en el mismo comando.

Tipo:PSApplicationGatewayBackendAddressPool
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-BackendAddressPoolId

Especifica el identificador de un grupo de direcciones de back-end existente que se puede agregar a los valores de configuración de la regla de ruta de acceso de puerta de enlace. Los identificadores de grupo de direcciones se pueden devolver mediante el cmdlet Get-AzApplicationGatewayBackendAddressPool. Después de tener el identificador, puede usar el parámetro DefaultBackendAddressPoolId en lugar del parámetro DefaultBackendAddressPool . Por ejemplo: -DefaultBackendAddressPoolId "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendAddressPools/ContosoAddressPool" El grupo de direcciones de back-end representa las direcciones IP en los servidores back-end. Estas direcciones IP deben pertenecer a la subred de red virtual o deben ser direcciones IP públicas.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-BackendHttpSettings

Especifica una referencia de objeto a una colección de valores HTTP de back-end que se van a agregar a los valores de configuración de la regla de ruta de acceso de puerta de enlace. Puede crear esta referencia de objeto mediante el cmdlet New-AzApplicationGatewayBackendHttpSettings y la sintaxis similar a esta: $HttpSettings = New-AzApplicationGatewayBackendHttpSettings -Name "ContosoHttpSettings" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled" La variable resultante, $HttpSettings, se puede usar como valor de parámetro para DefaultBackendAddressPool . parámetro: -DefaultBackendHttpSettings $HttpSettings La configuración HTTP de back-end configura propiedades como puerto, protocolo y afinidad basada en cookies para un grupo de back-end. Si usa este parámetro, no puede usar el parámetro DefaultBackendHttpSettingsId en el mismo comando.

Tipo:PSApplicationGatewayBackendHttpSettings
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-BackendHttpSettingsId

Especifica el identificador de una colección de configuraciones HTTP de back-end existente que se puede agregar a los valores de configuración de la regla de ruta de acceso de puerta de enlace. Los identificadores de configuración HTTP se pueden devolver mediante el cmdlet Get-AzApplicationGatewayBackendHttpSettings. Después de tener el identificador, puede usar el parámetro DefaultBackendHttpSettingsId en lugar del parámetro DefaultBackendHttpSettings . Por ejemplo: -DefaultBackendSettings Id "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendHttpSettingsCollection/ContosoHttpSettings" La configuración HTTP de back-end configura propiedades como el puerto, protocolo y afinidad basada en cookies para un grupo de back-end. Si usa este parámetro, no puede usar el parámetro DefaultBackendHttpSettings en el mismo comando.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-FirewallPolicy

Especifica la referencia de objeto a una directiva de firewall de nivel superior. La referencia de objeto se puede crear mediante el cmdlet New-AzApplicationGatewayWebApplicationFirewallPolicy. $firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name "wafPolicy1" -ResourceGroup "rgName" Se puede hacer referencia a una directiva de firewall creada con el commandlet anterior en un nivel de regla de ruta de acceso. el comando anterior crearía una configuración de directiva predeterminada y reglas administradas. En lugar de los valores predeterminados, los usuarios pueden especificar PolicySettings, ManagedRules mediante New-AzApplicationGatewayFirewallPolicySettings y New-AzApplicationGatewayFirewallPolicyManagedRules respectivamente.

Tipo:PSApplicationGatewayWebApplicationFirewallPolicy
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-FirewallPolicyId

Especifica el identificador de un recurso de firewall de aplicaciones web de nivel superior existente. Los identificadores de directiva de firewall se pueden devolver mediante el cmdlet Get-AzApplicationGatewayWebApplicationFirewallPolicy. Una vez que tengamos el identificador, puede usar el parámetro FirewallPolicyId en lugar del parámetro FirewallPolicy . Por ejemplo: -FirewallPolicyId /subscriptions/<subscription-id>/resourceGroups/<resource-group-id>/providers/Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies/<firewallPolicyName>

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Especifica el nombre de la configuración de la regla de ruta de acceso que crea este cmdlet.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Paths

Especifica una o varias reglas de ruta de acceso de puerta de enlace de aplicaciones.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RedirectConfiguration

Redirección de Application GatewayConfiguration

Tipo:PSApplicationGatewayRedirectConfiguration
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RedirectConfigurationId

Identificador de la redirección de Application GatewayConfiguration

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RewriteRuleSet

Application gateway RewriteRuleSet

Tipo:PSApplicationGatewayRewriteRuleSet
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RewriteRuleSetId

Id. de La puerta de enlace de aplicaciones RewriteRuleSet

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None

Salidas

PSApplicationGatewayPathRule