Set-AzApplicationGatewayHttpListener

Módulo:

Az.Network

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

Sintaxis

Set-AzApplicationGatewayHttpListener
   -ApplicationGateway <PSApplicationGateway>
   -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>]

Set-AzApplicationGatewayHttpListener
   -ApplicationGateway <PSApplicationGateway>
   -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 Set-AzApplicationGatewayHttpListener modifica un agente de escucha HTTP para una puerta de enlace de aplicaciones de Azure.

Ejemplos

Ejemplo 1: Establecimiento de un agente de escucha HTTP

$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-AzApplicationGatewayHttpListener -ApplicationGateway $AppGw -Name "Listener01" -Protocol Http -FrontendIpConfiguration $FIP01 -FrontendPort 80

El primer comando obtiene la puerta de enlace de aplicaciones denominada ApplicationGateway01 que pertenece al grupo de recursos denominado ResourceGroup01 y la almacena en la variable $AppGw. El segundo comando establece el agente de escucha HTTP para que la puerta de enlace use la configuración de front-end almacenada en $FIP 01 con el protocolo HTTP en el puerto 80.

Ejemplo 2: Agregar un agente de escucha HTTPS con SSL y hostNames

$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-AzApplicationGatewayHttpListener -ApplicationGateway $AppGw -Name "Listener01" -Protocol "Https" -FrontendIpConfiguration $FIP01 -FrontendPort $FP01 -SslCertificate $SSLCert01 -HostNames "*.contoso.com,www.microsoft.com"

El primer comando obtiene la puerta de enlace de aplicaciones y la almacena en la variable $AppGw. El segundo comando agrega el agente de escucha, que usa el protocolo HTTPS, con certificados SSL y nombres de host, a la puerta de enlace de aplicaciones.

Parámetros

-ApplicationGateway

Especifica la puerta de enlace de aplicaciones con la que este cmdlet asocia el agente de escucha HTTP.

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

-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

FirewallPolicy

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

-FirewallPolicyId

FirewallPolicyId

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

-FrontendIPConfiguration

Especifica la dirección IP de front-end de la puerta de enlace de aplicaciones.

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 dirección IP de front-end de la puerta de enlace de aplicaciones.

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 front-end de application Gateway.

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 de puerto de front-end de application Gateway.

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 al que este cmdlet envía 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

-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.

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. Los valores aceptables para este parámetro son:

• HTTP
• Https

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

Especifica si el cmdlet requiere una indicación de nombre de servidor. Los valores aceptables para este parámetro son: true o false.

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

-SslCertificate

Especifica el certificado SSL del 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 de certificado de capa de socket seguro (SSL) del 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

PSApplicationGateway

Salidas

PSApplicationGateway

Vínculos relacionados

• Add-AzApplicationGatewayHttpListener
• Get-AzApplicationGatewayHttpListener
• New-AzApplicationGatewayHttpListener
• Remove-AzApplicationGatewayHttpListener