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
Parâmetros: ApplicationGateway (ByValue)