Set-AzApplicationGatewayBackendHttpSetting
Atualiza as configurações HTTP de back-end para um gateway de aplicativo.
Sintaxe
Default (Predefinição)
Set-AzApplicationGatewayBackendHttpSetting
-ApplicationGateway <PSApplicationGateway>
-Name <String>
-Port <Int32>
-Protocol <String>
-CookieBasedAffinity <String>
[-RequestTimeout <Int32>]
[-ConnectionDraining <PSApplicationGatewayConnectionDraining>]
[-ProbeId <String>]
[-Probe <PSApplicationGatewayProbe>]
[-AuthenticationCertificates <PSApplicationGatewayAuthenticationCertificate[]>]
[-TrustedRootCertificate <PSApplicationGatewayTrustedRootCertificate[]>]
[-PickHostNameFromBackendAddress]
[-HostName <String>]
[-AffinityCookieName <String>]
[-Path <String>]
[-DedicatedBackendConnection <Boolean>]
[-ValidateCertChainAndExpiry <Boolean>]
[-ValidateSNI <Boolean>]
[-SniName <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
O cmdlet Set-AzApplicationGatewayBackendHttpSetting 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
$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-AzApplicationGatewayBackendHttpSetting -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.
Exemplo 2
Atualiza as configurações HTTP de back-end para um gateway de aplicativo. (autogenerated)
Set-AzApplicationGatewayBackendHttpSetting -ApplicationGateway <PSApplicationGateway> -CookieBasedAffinity Enabled -Name 'Setting02' -Port 88 -Probe <PSApplicationGatewayProbe> -Protocol https -RequestTimeout <Int32>
Parâmetros
-AffinityCookieName
Nome do cookie a utilizar para o cookie de afinidade
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-ApplicationGateway
Especifica um objeto de gateway de aplicativo ao qual esse cmdlet associa configurações HTTP de back-end.
Propriedades dos parâmetros
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: True Valor do pipeline: True Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-AuthenticationCertificates
Especifica certificados de autenticação para o gateway de aplicativo.
Propriedades dos parâmetros
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-ConnectionDraining
Drenagem de conexão do recurso de configurações http de back-end.
Propriedades dos parâmetros
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: 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.
Propriedades dos parâmetros
Tipo: String
Default value: None Valores aceites: Enabled, Disabled Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-DedicatedBackendConnection
Habilite ou desabilite a conexão dedicada por servidor back-end. O padrão é definido como false.
Propriedades dos parâmetros
Tipo: Nullable<T> [ Boolean ]
Default value: False Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.
Propriedades dos parâmetros
Tipo: IAzureContextContainer
Default value: None Suporta carateres universais: False NãoMostrar: False Aliases: AzContext, AzureRmContext, AzureCredential
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-HostName
Define o cabeçalho do host a ser enviado para os servidores de back-end.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Name
Especifica o nome do objeto de configurações HTTP de back-end.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: 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.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-PickHostNameFromBackendAddress
Sinalize se o cabeçalho do host deve ser escolhido do nome do host do servidor back-end.
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Port
Especifica a porta a ser usada para cada servidor no pool de servidores back-end.
Propriedades dos parâmetros
Tipo: Int32
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Probe
Especifica um teste a ser associado às configurações HTTP de back-end.
Propriedades dos parâmetros
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-ProbeId
Especifica a ID do teste a ser associado às configurações HTTP de back-end.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: 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.
Propriedades dos parâmetros
Tipo: String
Default value: None Valores aceites: Http, Https Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-RequestTimeout
Especifica um valor de tempo limite de solicitação.
Propriedades dos parâmetros
Tipo: Int32
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-SniName
Especifique um valor SNI para corresponder ao nome comum do certificado no back-end. Por padrão, o gateway de aplicativo usa o cabeçalho de host da solicitação de entrada como SNI. O valor padrão é null.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-TrustedRootCertificate
Certificados raiz confiáveis do gateway de aplicativo
Propriedades dos parâmetros
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-ValidateCertChainAndExpiry
Verifique ou ignore as validações em cadeia e de expiração do certificado no servidor back-end. O padrão é definido como true.
Propriedades dos parâmetros
Tipo: Nullable<T> [ Boolean ]
Default value: True Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-ValidateSNI
Quando habilitado, verifica se o Nome Comum do certificado fornecido pelo servidor back-end corresponde ao valor SNI (Indicação de Nome do Servidor). O valor predefinido é verdadeiro.
Propriedades dos parâmetros
Tipo: Nullable<T> [ Boolean ]
Default value: True Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters .
Saídas
