Compartir a través de

New-AzureRmApplicationGatewayPathRuleConfig

  • Referencia
Módulo:
AzureRM.Network

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

Advertencia

El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no se mantiene ni se admite, colocando cualquier uso continuado a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

Sintaxis

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

Description

El cmdlet New-AzureRmApplicationGatewayPathRuleConfig 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

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

Estos comandos crean una nueva regla de ruta de acceso de puerta de enlace de aplicaciones y, a continuación, usan el cmdlet Add-AzureRmApplicationGatewayUrlPathMapConfig 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 $Http Configuración) 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-AzureRmApplicationGatewayUrlPathMapConfig para agregar las opciones de configuración y la nueva regla de ruta de acceso contenida dentro de esas opciones a 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-AzureRmApplicationGatewayBackendAddressPool y la sintaxis similar a esta: $AddressPool = New-AzureRmApplicationGatewayBackendAddressPool -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 del grupo de direcciones se pueden devolver mediante el cmdlet Get-AzureRmApplicationGatewayBackendAddressPool. 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-AzureRmApplicationGatewayBackendHttp Configuración y la sintaxis similares a esta: $Http Configuración = New-AzureRmApplicationGatewayBackendHttp Configuración -Name "ContosoHttpSetings" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled" La variable resultante, $Http Configuración, se puede usar como valor de parámetro para el parámetro DefaultBackendAddressPool: -DefaultBackendHttp Configuración $Http Configuración 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 DefaultBackendHttp Configuración Id 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-AzureRmApplicationGatewayBackendHttp Configuración. Después de tener el identificador, puede usar el parámetro DefaultBackendHttp Configuración Id en lugar del parámetro DefaultBackendHttp Configuración. Por ejemplo: -DefaultBackend Configuración Identificador "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendHttp Configuración Collection/ContosoHttp Configuración" 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 DefaultBackendHttp Configuración 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:AzureRmContext, AzureCredential
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:List<T>[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

Entradas

None

Salidas

PSApplicationGatewayPathRule