New-AzApplicationGatewayHttpListener

Módulo:

Az.Network

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

Sintaxis

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

Tipo:	PSApplicationGatewayCustomError[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DefaultProfile

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

Tipo:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-FirewallPolicy

Especifica la referencia de objeto a una directiva de firewall de nivel superior. La referencia de objeto se puede crear mediante New-AzApplicationGatewayWebApplicationFirewallPolicy cmdlet. $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 PolicySettings, ManagedRules mediante New-AzApplicationGatewayFirewallPolicySettings y New-AzApplicationGatewayFirewallPolicyManagedRules respectivamente.

Tipo:	PSApplicationGatewayWebApplicationFirewallPolicy
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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 parámetro FirewallPolicyId en lugar de parámetro FirewallPolicy. Por ejemplo: -FirewallPolicyId "/subscriptions/<subscription-id>/resourceGroups/<resource-group-id>/providers/Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies/<firewallPolicyName>"

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-FrontendIPConfiguration

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

Tipo:	PSApplicationGatewayFrontendIPConfiguration
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-FrontendIPConfigurationId

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-FrontendPort

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

Tipo:	PSApplicationGatewayFrontendPort
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-FrontendPortId

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-HostName

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-HostNames

Nombres de host

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Name

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Protocol

Especifica el protocolo que usa el agente de escucha HTTP.

Tipo:	String
Valores aceptados:	Http, Https
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RequireServerNameIndication

Tipo:	String
Valores aceptados:	true, false
Posición:	Named
Valor predeterminado:	true
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SslCertificate

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

Tipo:	PSApplicationGatewaySslCertificate
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SslCertificateId

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SslProfile

SslProfile

Tipo:	PSApplicationGatewaySslProfile
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SslProfileId

SslProfileId

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

None

Salidas

PSApplicationGatewayHttpListener

Vínculos relacionados

• Add-AzApplicationGatewayHttpListener
• Get-AzApplicationGatewayHttpListener
• Remove-AzApplicationGatewayHttpListener
• Set-AzApplicationGatewayHttpListener