Compartir a través de


Set-AzureRmApplicationGatewayBackendHttpSettings

Actualiza la configuración HTTP de back-end para una puerta de enlace de aplicaciones.

Advertencia

El módulo AzureRM PowerShell ha quedado oficialmente obsoleto 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 recibirá mantenimiento ni soporte técnico, lo que significa que su uso continuado queda 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

Set-AzureRmApplicationGatewayBackendHttpSettings
   -ApplicationGateway <PSApplicationGateway>
   -Name <String>
   -Port <Int32>
   -Protocol <String>
   -CookieBasedAffinity <String>
   [-RequestTimeout <Int32>]
   [-ConnectionDraining <PSApplicationGatewayConnectionDraining>]
   [-ProbeId <String>]
   [-Probe <PSApplicationGatewayProbe>]
   [-AuthenticationCertificates <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayAuthenticationCertificate]>]
   [-TrustedRootCertificate <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayTrustedRootCertificate]>]
   [-PickHostNameFromBackendAddress]
   [-HostName <String>]
   [-AffinityCookieName <String>]
   [-Path <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

El cmdlet Set-AzureRmApplicationGatewayBackendHttpSettings actualiza la configuración del Protocolo de transferencia de hipertexto (HTTP) de back-end para una puerta de enlace de aplicaciones de Azure. La configuración HTTP de back-end se aplica a todos los servidores back-end de un grupo.

Ejemplos

Ejemplo 1: Actualización de la configuración HTTP de back-end para una puerta de enlace de aplicaciones

PS C:\>$AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\> $AppGw = Set-AzureRmApplicationGatewayBackendHttpSettings -ApplicationGateway $AppGw -Name "Setting02" -Port 88 -Protocol "Http" -CookieBasedAffinity "Disabled"

El primer comando obtiene la puerta de enlace de aplicaciones denominada ApplicationGateway01 que pertenece al grupo de recursos denominado ResourceGroup01 y la almacena en la variable $AppGw. El segundo comando actualiza la configuración HTTP de la puerta de enlace de aplicaciones en la variable $AppGw para usar el puerto 88, el protocolo HTTP y habilita la afinidad basada en cookies.

Parámetros

-AffinityCookieName

Nombre de cookie que se va a usar para la cookie de afinidad

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

-ApplicationGateway

Especifica un objeto de puerta de enlace de aplicaciones con el que este cmdlet asocia la configuración HTTP de back-end.

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

-AuthenticationCertificates

Especifica certificados de autenticación para la puerta de enlace de aplicaciones.

Tipo:List<T>[PSApplicationGatewayAuthenticationCertificate]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ConnectionDraining

Purga de conexiones del recurso de configuración http de back-end.

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

-CookieBasedAffinity

Especifica si la afinidad basada en cookies debe estar habilitada o deshabilitada para el grupo de servidores back-end. Los valores aceptables para este parámetro son: Disabled o Enabled.

Tipo:String
Valores aceptados:Enabled, Disabled
Posición:Named
Valor predeterminado:None
Requerido:True
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

-HostName

Establece el encabezado de host que se enviará a los servidores back-end.

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 del objeto de configuración HTTP de back-end.

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

-Path

Ruta de acceso que se debe usar como prefijo para todas las solicitudes HTTP. Si no se proporciona ningún valor para este parámetro, no se prefijo ninguna ruta de acceso.

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

-PickHostNameFromBackendAddress

Marca si se debe seleccionar el encabezado de host del nombre de host del servidor back-end.

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

-Port

Especifica el puerto que se va a usar para cada servidor del grupo de servidores back-end.

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

-Probe

Especifica un sondeo que se va a asociar a la configuración HTTP de back-end.

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

-ProbeId

Especifica el identificador del sondeo que se va a asociar a la configuración HTTP de back-end.

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

-Protocol

Especifica el protocolo que se va a usar para la comunicación entre la puerta de enlace de aplicaciones y los servidores back-end. Los valores aceptables para este parámetro son: Http y Https. Este parámetro distingue mayúsculas de minúsculas.

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

-RequestTimeout

Especifica un valor de tiempo de espera de solicitud.

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

-TrustedRootCertificate

Certificados raíz de confianza de Application Gateway

Tipo:List<T>[PSApplicationGatewayTrustedRootCertificate]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

PSApplicationGateway

Parámetros: ApplicationGateway (ByValue)

Salidas

PSApplicationGateway