Set-AzApplicationGatewayHttpListener
Modifica um ouvinte HTTP para um gateway de aplicativo.
Sintaxe
Set-AzApplicationGatewayHttpListener
-ApplicationGateway <PSApplicationGateway>
-Name <String>
[-FrontendIPConfigurationId <String>]
[-FrontendPortId <String>]
[-SslCertificateId <String>]
[-FirewallPolicyId <String>]
[-SslProfileId <String>]
[-HostName <String>]
[-HostNames <String[]>]
[-RequireServerNameIndication <String>]
-Protocol <String>
[-CustomErrorConfiguration <PSApplicationGatewayCustomError[]>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Set-AzApplicationGatewayHttpListener
-ApplicationGateway <PSApplicationGateway>
-Name <String>
[-FrontendIPConfiguration <PSApplicationGatewayFrontendIPConfiguration>]
[-FrontendPort <PSApplicationGatewayFrontendPort>]
[-FirewallPolicy <PSApplicationGatewayWebApplicationFirewallPolicy>]
[-SslCertificate <PSApplicationGatewaySslCertificate>]
[-SslProfile <PSApplicationGatewaySslProfile>]
[-HostName <String>]
[-HostNames <String[]>]
[-RequireServerNameIndication <String>]
-Protocol <String>
[-CustomErrorConfiguration <PSApplicationGatewayCustomError[]>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
O cmdlet Set-AzApplicationGatewayHttpListener modifica um ouvinte HTTP para um gateway de aplicativo do Azure.
Exemplos
Exemplo 1: Definir um ouvinte HTTP
$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-AzApplicationGatewayHttpListener -ApplicationGateway $AppGw -Name "Listener01" -Protocol Http -FrontendIpConfiguration $FIP01 -FrontendPort 80
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 define o ouvinte HTTP do gateway para usar a configuração front-end armazenada em $FIP 01 com o protocolo HTTP na porta 80.
Exemplo 2: Adicionar um ouvinte HTTPS com SSL e HostNames
$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-AzApplicationGatewayHttpListener -ApplicationGateway $AppGw -Name "Listener01" -Protocol "Https" -FrontendIpConfiguration $FIP01 -FrontendPort $FP01 -SslCertificate $SSLCert01 -HostNames "*.contoso.com,www.microsoft.com"
O primeiro comando obtém o gateway de aplicativo e o armazena na variável $AppGw. O segundo comando adiciona o ouvinte, que usa o protocolo HTTPS, com certificados SSL e HostNames, ao gateway do aplicativo.
Parâmetros
-ApplicationGateway
Especifica o gateway de aplicativo ao qual esse cmdlet associa o ouvinte HTTP.
Tipo: | PSApplicationGateway |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-CustomErrorConfiguration
Erro do cliente de um gateway de aplicativo
Tipo: | PSApplicationGatewayCustomError[] |
Position: | Named |
Default value: | None |
Necessário: | False |
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: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-FirewallPolicy
FirewallPolicy
Tipo: | PSApplicationGatewayWebApplicationFirewallPolicy |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-FirewallPolicyId
FirewallPolicyId
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-FrontendIPConfiguration
Especifica o endereço IP front-end do gateway de aplicativo.
Tipo: | PSApplicationGatewayFrontendIPConfiguration |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-FrontendIPConfigurationId
Especifica a ID do endereço IP front-end do gateway de aplicativo.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-FrontendPort
Especifica a porta front-end do gateway de aplicativo.
Tipo: | PSApplicationGatewayFrontendPort |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-FrontendPortId
Especifica o ID da porta front-end do gateway de aplicativo.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-HostName
Especifica o nome do host para o qual esse cmdlet envia o ouvinte HTTP.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-HostNames
Nomes de anfitrião
Tipo: | String[] |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-Name
Especifica o nome do ouvinte HTTP.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-Protocol
Especifica o protocolo que o ouvinte HTTP usa. Os valores aceitáveis para este parâmetro são:
- Http
- Disponível em:
Tipo: | String |
Valores aceites: | Http, Https |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-RequireServerNameIndication
Especifica se o cmdlet requer uma indicação de nome de servidor. Os valores aceitáveis para este parâmetro são: true ou false.
Tipo: | String |
Valores aceites: | true, false |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-SslCertificate
Especifica o certificado SSL do ouvinte HTTP.
Tipo: | PSApplicationGatewaySslCertificate |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-SslCertificateId
Especifica a ID do certificado SSL (Secure Socket Layer) do ouvinte HTTP.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-SslProfile
SslProfile
Tipo: | PSApplicationGatewaySslProfile |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-SslProfileId
SslProfileId
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |