New-AzApplicationGatewayHttpListener
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
Tipo: | PSApplicationGatewayCustomError[] |
Position: | Named |
valor predeterminado: | None |
Requerido: | 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.
Tipo: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
valor predeterminado: | None |
Requerido: | 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.
Tipo: | PSApplicationGatewayWebApplicationFirewallPolicy |
Position: | Named |
valor predeterminado: | None |
Requerido: | 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>"
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | 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.
Tipo: | PSApplicationGatewayFrontendIPConfiguration |
Position: | Named |
valor predeterminado: | None |
Requerido: | 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.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FrontendPort
Especifica el puerto de front-end para el agente de escucha HTTP.
Tipo: | PSApplicationGatewayFrontendPort |
Position: | Named |
valor predeterminado: | None |
Requerido: | 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.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HostName
Especifica el nombre de host del agente de escucha HTTP de Application Gateway.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HostNames
Nombre de host
Tipo: | String[] |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especifica el nombre del agente de escucha HTTP que crea este cmdlet.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Protocol
Especifica el protocolo que usa el agente de escucha HTTP.
Tipo: | String |
valores aceptados: | Http, Https |
Position: | Named |
valor predeterminado: | None |
Requerido: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequireServerNameIndication
Tipo: | String |
valores aceptados: | true, false |
Position: | Named |
valor predeterminado: | true |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SslCertificate
Especifica el objeto de certificado SSL para el agente de escucha HTTP.
Tipo: | PSApplicationGatewaySslCertificate |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SslCertificateId
Especifica el identificador del certificado SSL para el agente de escucha HTTP.
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SslProfile
SslProfile
Tipo: | PSApplicationGatewaySslProfile |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SslProfileId
SslProfileId
Tipo: | String |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
None
Salidas
PSApplicationGatewayHttpListener
Vínculos relacionados
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de