Condividi tramite

New-AzApplicationGatewayHttpListener

  • Riferimento
Modulo:
Az.Network

Crea un listener HTTP per un gateway applicazione.

Sintassi

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

Descrizione

Il cmdlet New-AzApplicationGatewayHttpListener crea un listener HTTP per un gateway applicazione di Azure.

Esempio

Esempio 1: Creare un listener HTTP

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

Questo comando crea un listener HTTP denominato Listener01 e archivia il risultato nella variabile denominata $Listener.

Esempio 2: Creare un listener HTTP con SSL

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

Questo comando crea un listener HTTP che usa l'offload SSL e fornisce il certificato SSL nella variabile $SSLCert 01. Il comando archivia il risultato nella variabile denominata $Listener.

Esempio 3: Creare un listener HTTP con firewall-policy

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

Questo comando crea un listener HTTP denominato Listener01, FirewallPolicy come $firewallPolicy e archivia il risultato nella variabile denominata $Listener.

Esempio 4: Aggiungere un listener HTTPS con SSL e HostNames

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

Questo comando crea un listener HTTP che usa l'offload SSL e fornisce il certificato SSL nella variabile $SSLCert 01 insieme a due Nomi Host. Il comando archivia il risultato nella variabile denominata $Listener.

Parametri

-CustomErrorConfiguration

Errore del cliente di un gateway applicazione

Tipo:PSApplicationGatewayCustomError[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-FirewallPolicy

Specifica il riferimento all'oggetto a un criterio firewall di primo livello. Il riferimento all'oggetto può essere creato usando New-AzApplicationGatewayWebApplicationFirewallPolicy cmdlet. $firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name "wafPolicy1" -ResourceGroup "rgName" È possibile fare riferimento a un criterio firewall creato usando il commandlet precedente. il comando precedente creerebbe le impostazioni predefinite dei criteri e le regole gestite. Anziché i valori predefiniti, gli utenti possono specificare PolicySettings, ManagedRules usando rispettivamente New-AzApplicationGatewayFirewallPolicySettings e New-AzApplicationGatewayFirewallPolicyManagedRules.

Tipo:PSApplicationGatewayWebApplicationFirewallPolicy
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-FirewallPolicyId

Specifica l'ID di una risorsa web application firewall di primo livello esistente. Gli ID dei criteri del firewall possono essere restituiti usando il cmdlet Get-AzApplicationGatewayWebApplicationFirewallPolicy. Dopo aver ottenuto l'ID, è possibile usare parametro FirewallPolicyId anziché parametro FirewallPolicy. Ad esempio: -FirewallPolicyId "/subscriptions/<subscription-id>/resourceGroups/<resource-group-id>/providers/Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies/<firewallPolicyName>"

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-FrontendIPConfiguration

Specifica l'oggetto di configurazione IP front-end per il listener HTTP.

Tipo:PSApplicationGatewayFrontendIPConfiguration
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-FrontendIPConfigurationId

Specifica l'ID della configurazione IP front-end per il listener HTTP.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-FrontendPort

Specifica la porta front-end per il listener HTTP.

Tipo:PSApplicationGatewayFrontendPort
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-FrontendPortId

Specifica l'ID dell'oggetto porta front-end per il listener HTTP.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-HostName

Specifica il nome host del listener HTTP del gateway applicazione.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-HostNames

Nomi host

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specifica il nome del listener HTTP creato da questo cmdlet.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Protocol

Specifica il protocollo utilizzato dal listener HTTP.

Tipo:String
Valori accettati:Http, Https
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RequireServerNameIndication

Tipo:String
Valori accettati:true, false
Posizione:Named
Valore predefinito:true
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SslCertificate

Specifica l'oggetto certificato SSL per il listener HTTP.

Tipo:PSApplicationGatewaySslCertificate
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SslCertificateId

Specifica l'ID del certificato SSL per il listener HTTP.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SslProfile

SslProfile

Tipo:PSApplicationGatewaySslProfile
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SslProfileId

SslProfileId

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output