Partilhar via


Add-AzureRmApplicationGatewayHttpListener

Adiciona um ouvinte HTTP 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.

Syntax

Add-AzureRmApplicationGatewayHttpListener
   -ApplicationGateway <PSApplicationGateway>
   -Name <String>
   [-FrontendIPConfigurationId <String>]
   [-FrontendPortId <String>]
   [-SslCertificateId <String>]
   [-HostName <String>]
   [-RequireServerNameIndication <String>]
   -Protocol <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzureRmApplicationGatewayHttpListener
   -ApplicationGateway <PSApplicationGateway>
   -Name <String>
   [-FrontendIPConfiguration <PSApplicationGatewayFrontendIPConfiguration>]
   [-FrontendPort <PSApplicationGatewayFrontendPort>]
   [-SslCertificate <PSApplicationGatewaySslCertificate>]
   [-HostName <String>]
   [-RequireServerNameIndication <String>]
   -Protocol <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

O cmdlet Add-AzureRmApplicationGatewayHttpListener adiciona um ouvinte HTTP a um gateway de aplicativo.

Exemplos

Exemplo 1: Adicionar um ouvinte HTTP

PS C:\>$AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\> $Appgw = Add-AzureRmApplicationGatewayHttpListener -ApplicationGateway $AppGw -Name "listener01" -Protocol "Http" -FrontendIpConfiguration $FIP01 -FrontendPort $FP01

O primeiro comando obtém o gateway de aplicativo e o armazena na variável $AppGw. O segundo comando adiciona o ouvinte HTTP ao gateway de aplicativo.

Exemplo 2: Adicionar um ouvinte HTTPS com SSL

PS C:\>$AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\> $AppGw = Add-AzureRmApplicationGatewayHttpListener -ApplicationGateway $AppGw -Name "Listener01" -Protocol "Https" -FrontendIpConfiguration $FIP01 -FrontendPort $FP01 -SslCertificate $SSLCert01

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, ao gateway de aplicativo.

Parâmetros

-ApplicationGateway

Especifica o gateway de aplicativo ao qual esse cmdlet adiciona um ouvinte HTTP.

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

-FrontendIPConfiguration

Especifica o objeto de recurso IP front-end do gateway de aplicativo.

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

-FrontendIPConfigurationId

Especifica o ID IP front-end do gateway de aplicativo.

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

-FrontendPort

Especifica o objeto de porta front-end do gateway de aplicativo.

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

-FrontendPortId

Especifica o ID da porta front-end do gateway de aplicativo.

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

-HostName

Especifica o nome do host ao qual esse cmdlet adiciona um ouvinte HTTP.

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

-Name

Especifica o nome da porta front-end adicionada por esse comando.

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

-Protocol

Especifica o protocolo do ouvinte HTTP. Há suporte para HTTP e HTTPS.

Tipo:String
valores aceites:Http, Https
Position:Named
valor predefinido:None
Necessário:True
Accept pipeline input:False
Accept wildcard characters:False

-RequireServerNameIndication

Tipo:String
valores aceites:true, false
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-SslCertificate

Especifica o certificado SSL do ouvinte HTTP. Deve ser especificado se HTTPS for escolhido como protocolo de ouvinte.

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

-SslCertificateId

Especifica a ID do certificado SSL do ouvinte HTTP. Deve ser especificado se HTTPS for escolhido como protocolo de ouvinte.

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

Entradas

PSApplicationGateway

Parâmetros: ApplicationGateway (ByValue)

Saídas

PSApplicationGateway