Partilhar via


Set-AzureRmApplicationGatewayBackendHttpSettings

Atualiza as configurações HTTP de back-end para um gateway de aplicativo.

Aviso

O módulo AzureRM PowerShell foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo Az PowerShell para garantir suporte e atualizações contínuos.

Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.

Sintaxe

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

O cmdlet Set-AzureRmApplicationGatewayBackendHttpSettings atualiza as configurações HTTP (Hypertext Transfer Protocol) back-end para um gateway de aplicativo do Azure. As configurações HTTP back-end são aplicadas a todos os servidores back-end em um pool.

Exemplos

Exemplo 1: Atualizar as configurações HTTP de back-end para um gateway de aplicativo

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

O primeiro comando obtém o gateway de aplicativo chamado ApplicationGateway01 que pertence ao grupo de recursos chamado ResourceGroup01 e o armazena na variável $AppGw. O segundo comando atualiza as configurações HTTP do gateway de aplicativo na variável $AppGw para usar a porta 88, o protocolo HTTP e habilita a afinidade baseada em cookie.

Parâmetros

-AffinityCookieName

Nome do cookie a utilizar para o cookie de afinidade

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ApplicationGateway

Especifica um objeto de gateway de aplicativo ao qual esse cmdlet associa configurações HTTP de back-end.

Tipo:PSApplicationGateway
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-AuthenticationCertificates

Especifica certificados de autenticação para o gateway de aplicativo.

Tipo:List<T>[PSApplicationGatewayAuthenticationCertificate]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ConnectionDraining

Drenagem de conexão do recurso de configurações http de back-end.

Tipo:PSApplicationGatewayConnectionDraining
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-CookieBasedAffinity

Especifica se a afinidade baseada em cookies deve ser habilitada ou desabilitada para o pool de servidores back-end. Os valores aceitáveis para este parâmetro são: Disabled ou Enabled.

Tipo:String
Valores aceites:Enabled, Disabled
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-HostName

Define o cabeçalho do host a ser enviado para os servidores de back-end.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Name

Especifica o nome do objeto de configurações HTTP de back-end.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Path

Caminho que deve ser usado como um prefixo para todas as solicitações HTTP. Se nenhum valor for fornecido para esse parâmetro, nenhum caminho será prefixado.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PickHostNameFromBackendAddress

Sinalize se o cabeçalho do host deve ser escolhido do nome do host do servidor back-end.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Port

Especifica a porta a ser usada para cada servidor no pool de servidores back-end.

Tipo:Int32
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Probe

Especifica um teste a ser associado às configurações HTTP de back-end.

Tipo:PSApplicationGatewayProbe
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ProbeId

Especifica a ID do teste a ser associado às configurações HTTP de back-end.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Protocol

Especifica o protocolo a ser usado para comunicação entre o gateway de aplicativo e os servidores back-end. Os valores aceitáveis para este parâmetro são: Http e Https. Este parâmetro diferencia maiúsculas de minúsculas.

Tipo:String
Valores aceites:Http, Https
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RequestTimeout

Especifica um valor de tempo limite de solicitação.

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-TrustedRootCertificate

Certificados raiz confiáveis do gateway de aplicativo

Tipo:List<T>[PSApplicationGatewayTrustedRootCertificate]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

PSApplicationGateway

Parâmetros: ApplicationGateway (ByValue)

Saídas

PSApplicationGateway