Set-AzureRmApplicationGatewayBackendHttpSettings

Referência

Módulo:: AzureRM.Network

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.

Syntax

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
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationGateway

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

Tipo:	PSApplicationGateway
Position:	Named
valor predefinido:	None
Necessário:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-AuthenticationCertificates

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

Tipo:	List<T>[PSApplicationGatewayAuthenticationCertificate]
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConnectionDraining

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

Tipo:	PSApplicationGatewayConnectionDraining
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	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
valor predefinido:	None
Necessário:	True
Accept pipeline input:	False
Accept wildcard characters:	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
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HostName

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

Tipo:	String
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

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

Tipo:	String
Position:	Named
valor predefinido:	None
Necessário:	True
Accept pipeline input:	False
Accept wildcard characters:	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
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PickHostNameFromBackendAddress

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

Tipo:	SwitchParameter
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Port

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

Tipo:	Int32
Position:	Named
valor predefinido:	None
Necessário:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Probe

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

Tipo:	PSApplicationGatewayProbe
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ProbeId

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

Tipo:	String
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	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
valor predefinido:	None
Necessário:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-RequestTimeout

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

Tipo:	Int32
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TrustedRootCertificate

Certificados raiz confiáveis do gateway de aplicativo

Tipo:	List<T>[PSApplicationGatewayTrustedRootCertificate]
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

PSApplicationGateway

Parâmetros: ApplicationGateway (ByValue)

Saídas