Partilhar via


Add-AzureRmApplicationGatewayBackendHttpSettings

Adiciona configurações HTTP de back-end a 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

Add-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 Add-AzureRmApplicationGatewayBackendHttpSettings adiciona configurações HTTP back-end a um gateway de aplicativo. As configurações HTTP back-end são aplicadas a todos os servidores back-end no pool.

Exemplos

Exemplo 1: Adicionar configurações HTTP de back-end a um gateway de aplicativo

PS C:\>$AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\> $AppGw = Add-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 adiciona configurações HTTP de back-end ao gateway de aplicativo, definindo a porta como 88 e o protocolo como HTTP e nomeia as configurações como Setting02.

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 o nome do gateway de aplicativo para o qual esse cmdlet adiciona configurações.

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, 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 das configurações HTTP de back-end adicionadas por esse cmdlet.

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 do 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 uma sonda a ser associada a um servidor 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 ao servidor 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 para comunicação entre gateway de aplicativo e servidores back-end. Os valores aceitáveis para este parâmetro são: Http e Https.

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 o valor de tempo limite da 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