New-AzApplicationGatewayHttpListener

  • Referencia
Módulo:
Az.Network

Crea un agente de escucha HTTP para una puerta de enlace de aplicaciones.

Syntax

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

El cmdlet New-AzApplicationGatewayHttpListener crea un agente de escucha HTTP para una puerta de enlace de aplicaciones de Azure.

Ejemplos

Ejemplo 1: Creación de un agente de escucha HTTP

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

Este comando crea un agente de escucha HTTP denominado Listener01 y almacena el resultado en la variable denominada $Listener.

Ejemplo 2: Creación de un agente de escucha HTTP con SSL

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

Este comando crea un agente de escucha HTTP que usa la descarga SSL y proporciona el certificado SSL en la variable $SSLCert 01. El comando almacena el resultado en la variable denominada $Listener.

Ejemplo 3: Creación de un agente de escucha HTTP con firewall-policy

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

Este comando crea un agente de escucha HTTP denominado Listener01, FirewallPolicy como $firewallPolicy y almacena el resultado en la variable denominada $Listener.

Ejemplo 4: Agregar un agente de escucha HTTPS con SSL y HostNames

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

Este comando crea un agente de escucha HTTP que usa la descarga SSL y proporciona el certificado SSL en la variable $SSLCert 01 junto con dos nombres de host. El comando almacena el resultado en la variable denominada $Listener.

Parámetros

-CustomErrorConfiguration

Error del cliente de una puerta de enlace de aplicaciones

Type:PSApplicationGatewayCustomError[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FirewallPolicy

Especifica la referencia de objeto a una directiva de firewall de nivel superior. La referencia de objeto se puede crear mediante el cmdlet New-AzApplicationGatewayWebApplicationFirewallPolicy. $firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name "wafPolicy1" -ResourceGroup "rgName" Se puede hacer referencia a una directiva de firewall creada con el commandlet anterior en un nivel de regla de ruta de acceso. el comando anterior crearía una configuración de directiva predeterminada y reglas administradas. En lugar de los valores predeterminados, los usuarios pueden especificar Policy Configuración, ManagedRules mediante New-AzApplicationGatewayFirewallPolicy Configuración y New-AzApplicationGatewayFirewallPolicyManagedRules respectivamente.

Type:PSApplicationGatewayWebApplicationFirewallPolicy
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FirewallPolicyId

Especifica el identificador de un recurso de firewall de aplicaciones web de nivel superior existente. Los identificadores de directiva de firewall se pueden devolver mediante el cmdlet Get-AzApplicationGatewayWebApplicationFirewallPolicy. Una vez que tengamos el identificador, puede usar el parámetro FirewallPolicyId en lugar del parámetro FirewallPolicy . Por ejemplo: -FirewallPolicyId "/subscriptions/<subscription-id>/resourceGroups/<resource-group-id>/providers/Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies/<firewallPolicyName>"

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FrontendIPConfiguration

Especifica el objeto de configuración de IP de front-end para el agente de escucha HTTP.

Type:PSApplicationGatewayFrontendIPConfiguration
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FrontendIPConfigurationId

Especifica el identificador de la configuración ip de front-end para el agente de escucha HTTP.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FrontendPort

Especifica el puerto de front-end para el agente de escucha HTTP.

Type:PSApplicationGatewayFrontendPort
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FrontendPortId

Especifica el identificador del objeto de puerto de front-end para el agente de escucha HTTP.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HostName

Especifica el nombre de host del agente de escucha HTTP de Application Gateway.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HostNames

Nombre de host

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifica el nombre del agente de escucha HTTP que crea este cmdlet.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Protocol

Especifica el protocolo que usa el agente de escucha HTTP.

Type:String
Accepted values:Http, Https
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RequireServerNameIndication

Type:String
Accepted values:true, false
Position:Named
Default value:true
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SslCertificate

Especifica el objeto de certificado SSL para el agente de escucha HTTP.

Type:PSApplicationGatewaySslCertificate
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SslCertificateId

Especifica el identificador del certificado SSL para el agente de escucha HTTP.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SslProfile

SslProfile

Type:PSApplicationGatewaySslProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SslProfileId

SslProfileId

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

None

Salidas

PSApplicationGatewayHttpListener