Partilhar via

New-AzApplicationGatewayHttpListener

  • Referência
Módulo:
Az.Network

Cria um ouvinte HTTP para um gateway de aplicativo.

Sintaxe

New-AzApplicationGatewayHttpListener
   -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>]
New-AzApplicationGatewayHttpListener
   -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 New-AzApplicationGatewayHttpListener cria um ouvinte HTTP para um gateway de aplicativo do Azure.

Exemplos

Exemplo 1: Criar um ouvinte HTTP

$Listener = New-AzApplicationGatewayHttpListener -Name "Listener01" -Protocol "Http" -FrontendIpConfiguration $FIp01 -FrontendPort $FP01

Este comando cria um ouvinte HTTP chamado Listener01 e armazena o resultado na variável chamada $Listener.

Exemplo 2: Criar um ouvinte HTTP com SSL

$Listener = New-AzApplicationGatewayHttpListener -Name "Listener01" -Protocol "Https" -FrontendIpConfiguration $FIp01 -FrontendPort $FP01 -SslCertificate $SSLCert01

Este comando cria um ouvinte HTTP que usa o descarregamento SSL e fornece o certificado SSL na variável $SSLCert 01. O comando armazena o resultado na variável chamada $Listener.

Exemplo 3: Criar um ouvinte HTTP com firewall-policy

$Listener = New-AzApplicationGatewayHttpListener -Name "Listener01" -Protocol "Http" -FrontendIpConfiguration $FIp01 -FrontendPort $FP01 -FirewallPolicy $firewallPolicy

Este comando cria um ouvinte HTTP chamado Listener01, FirewallPolicy como $firewallPolicy e armazena o resultado na variável chamada $Listener.

Exemplo 4: Adicionar um ouvinte HTTPS com SSL e HostNames

$Listener = New-AzApplicationGatewayHttpListener -Name "Listener01" -Protocol "Https" -FrontendIpConfiguration $FIp01 -FrontendPort $FP01 -SslCertificate $SSLCert01 -HostNames "*.contoso.com","www.microsoft.com"

Este comando cria um ouvinte HTTP que usa o descarregamento SSL e fornece o certificado SSL na variável $SSLCert 01 junto com dois HostNames. O comando armazena o resultado na variável chamada $Listener.

Parâmetros

-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

Especifica a referência de objeto a uma diretiva de firewall de nível superior. A referência de objeto pode ser criada usando New-AzApplicationGatewayWebApplicationFirewallPolicy cmdlet. $firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name "wafPolicy1" -ResourceGroup "rgName" Uma política de firewall criada usando o commandlet acima pode ser referida em um nível de regra de caminho. o comando acima criaria uma configuração de política padrão e regras gerenciadas. Em vez dos valores padrão, os usuários podem especificar PolicySettings, ManagedRules usando New-AzApplicationGatewayFirewallPolicySettings e New-AzApplicationGatewayFirewallPolicyManagedRules respectivamente.

Tipo:PSApplicationGatewayWebApplicationFirewallPolicy
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-FirewallPolicyId

Especifica a ID de um recurso de firewall de aplicativo Web de nível superior existente. As IDs de política de firewall podem ser retornadas usando o cmdlet Get-AzApplicationGatewayWebApplicationFirewallPolicy. Depois de termos o ID, você pode usar parâmetro FirewallPolicyId em vez de parâmetro FirewallPolicy. Por exemplo: -FirewallPolicyId "/subscriptions/<subscription-id>/resourceGroups/<resource-group-id>/providers/Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies/<firewallPolicyName>"

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-FrontendIPConfiguration

Especifica o objeto de configuração IP front-end para o ouvinte HTTP.

Tipo:PSApplicationGatewayFrontendIPConfiguration
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-FrontendIPConfigurationId

Especifica a ID da configuração IP front-end para o ouvinte HTTP.

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 para o ouvinte HTTP.

Tipo:PSApplicationGatewayFrontendPort
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-FrontendPortId

Especifica a ID do objeto de porta front-end para o ouvinte HTTP.

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 do ouvinte HTTP do gateway de aplicativo.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-HostNames

Nomes de host

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 que este cmdlet cria.

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.

Tipo:String
Valores aceites:Http, Https
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RequireServerNameIndication

Tipo:String
Valores aceites:true, false
Position:Named
Default value:true
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SslCertificate

Especifica o objeto de certificado SSL para o 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 para o 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

Entradas

None

Saídas

PSApplicationGatewayHttpListener