Partilhar via


Add-AzApplicationGatewayBackendHttpSetting

Adiciona configurações HTTP de back-end a um gateway de aplicativo.

Sintaxe

Default (Predefinição)

Add-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 Add-AzApplicationGatewayBackendHttpSetting adiciona configurações HTTP de 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

$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Add-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 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.

Exemplo 2

Adiciona configurações HTTP de back-end a um gateway de aplicativo. (autogenerated)

Add-AzApplicationGatewayBackendHttpSetting -ApplicationGateway <PSApplicationGateway> -CookieBasedAffinity Enabled -Name 'Setting02' -PickHostNameFromBackendAddress -Port 88 -Probe <PSApplicationGatewayProbe> -Protocol http -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 o nome do gateway de aplicativo para o qual esse cmdlet adiciona configurações.

Propriedades dos parâmetros

Tipo:PSApplicationGateway
Default value:None
Suporta carateres universais:False
NãoMostrar:False

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

Tipo:

PSApplicationGatewayAuthenticationCertificate[]

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

-ConnectionDraining

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

Propriedades dos parâmetros

Tipo:PSApplicationGatewayConnectionDraining
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

-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.

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

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 do 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 uma sonda a ser associada a um servidor back-end.

Propriedades dos parâmetros

Tipo:PSApplicationGatewayProbe
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

-ProbeId

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

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

Tipo:

PSApplicationGatewayTrustedRootCertificate[]

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

-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.

Entradas

PSApplicationGateway

Saídas

PSApplicationGateway