New-AzApplicationGatewayHttpListener

Modul:

Az.Network Module

Vytvoří naslouchací proces HTTP pro aplikační bránu.

Syntax

SetByResourceId

New-AzApplicationGatewayHttpListener
    -Name <String>
    -Protocol <String>
    [-FrontendIPConfigurationId <String>]
    [-FrontendPortId <String>]
    [-SslCertificateId <String>]
    [-FirewallPolicyId <String>]
    [-SslProfileId <String>]
    [-HostName <String>]
    [-HostNames <String[]>]
    [-RequireServerNameIndication <String>]
    [-CustomErrorConfiguration <PSApplicationGatewayCustomError[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

SetByResource

New-AzApplicationGatewayHttpListener
    -Name <String>
    -Protocol <String>
    [-FrontendIPConfiguration <PSApplicationGatewayFrontendIPConfiguration>]
    [-FrontendPort <PSApplicationGatewayFrontendPort>]
    [-FirewallPolicy <PSApplicationGatewayWebApplicationFirewallPolicy>]
    [-SslCertificate <PSApplicationGatewaySslCertificate>]
    [-SslProfile <PSApplicationGatewaySslProfile>]
    [-HostName <String>]
    [-HostNames <String[]>]
    [-RequireServerNameIndication <String>]
    [-CustomErrorConfiguration <PSApplicationGatewayCustomError[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

Rutina New-AzApplicationGatewayHttpListener vytvoří naslouchací proces HTTP pro aplikační bránu Azure.

Příklady

Příklad 1: Vytvoření naslouchacího procesu HTTP

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

Tento příkaz vytvoří naslouchací proces HTTP s názvem Listener01 a uloží výsledek do proměnné s názvem $Listener.

Příklad 2: Vytvoření naslouchacího procesu HTTP pomocí SSL

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

Tento příkaz vytvoří naslouchací proces HTTP, který používá přesměrování zpracování SSL, a poskytne certifikát SSL v proměnné $SSLCert 01. Příkaz uloží výsledek do proměnné s názvem $Listener.

Příklad 3: Vytvoření naslouchacího procesu HTTP se zásadami brány firewall

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

Tento příkaz vytvoří naslouchací proces HTTP s názvem Listener01, FirewallPolicy jako $firewallPolicy a uloží výsledek do proměnné s názvem $Listener.

Příklad 4: Přidání naslouchacího procesu HTTPS s protokolem SSL a názvy hostitelů

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

Tento příkaz vytvoří naslouchací proces HTTP, který používá přesměrování zpracování SSL a poskytne certifikát SSL v proměnné $SSLCert 01 spolu se dvěma názvy hostitelů. Příkaz uloží výsledek do proměnné s názvem $Listener.

Parametry

-CustomErrorConfiguration

Chyba zákazníka služby Application Gateway

Vlastnosti parametru

Typ:	PSApplicationGatewayCustomError[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Vlastnosti parametru

Typ:	IAzureContextContainer
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	AzContext, AzureRmContext, AzureCredential

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-FirewallPolicy

Určuje odkaz na objekt na zásady brány firewall nejvyšší úrovně. Odkaz na objekt lze vytvořit pomocí rutiny New-AzApplicationGatewayWebApplicationFirewallPolicy. $firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name "wafPolicy1" -ResourceGroup "rgName" Zásady brány firewall vytvořené pomocí výše uvedené rutiny lze odkazovat na úroveň pravidla cesty. výše uvedený příkaz vytvoří výchozí nastavení zásad a spravovaná pravidla. Místo výchozích hodnot můžou uživatelé zadat PolicySettings, ManagedRules pomocí New-AzApplicationGatewayFirewallPolicySettings a New-AzApplicationGatewayFirewallPolicyManagedRules.

Vlastnosti parametru

Typ:	PSApplicationGatewayWebApplicationFirewallPolicy
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResource

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-FirewallPolicyId

Určuje ID existujícího prostředku firewallu webových aplikací nejvyšší úrovně. ID zásad brány firewall je možné vrátit pomocí rutiny Get-AzApplicationGatewayWebApplicationFirewallPolicy. Jakmile máme ID, můžete místo parametru FirewallPolicyId použít parametr FirewallPolicyId. Například: -FirewallPolicyId "/subscriptions/<subscription-id>/resourceGroups/<resource-group-id>/providers/Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies/<firewallPolicyName>"

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResourceId

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-FrontendIPConfiguration

Určuje objekt konfigurace front-end IP pro naslouchací proces HTTP.

Vlastnosti parametru

Typ:	PSApplicationGatewayFrontendIPConfiguration
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResource

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-FrontendIPConfigurationId

Určuje ID konfigurace front-endOVÉ IP adresy pro naslouchací proces HTTP.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResourceId

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-FrontendPort

Určuje front-endový port pro naslouchací proces HTTP.

Vlastnosti parametru

Typ:	PSApplicationGatewayFrontendPort
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResource

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-FrontendPortId

Určuje ID objektu front-end portu pro naslouchací proces HTTP.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResourceId

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-HostName

Určuje název hostitele naslouchacího procesu HTTP aplikační brány.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-HostNames

Názvy hostitelů

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Name

Určuje název naslouchacího procesu HTTP, který tato rutina vytvoří.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Protocol

Určuje protokol, který používá naslouchací proces HTTP.

Vlastnosti parametru

Typ:	String
Default value:	None
Přípustné hodnoty:	Http, Https
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-RequireServerNameIndication

Rutina New-AzApplicationGatewayHttpListener vytvoří naslouchací proces HTTP pro aplikační bránu Azure.

Vlastnosti parametru

Typ:	String
Default value:	true
Přípustné hodnoty:	true, false
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-SslCertificate

Určuje objekt certifikátu SSL pro naslouchací proces HTTP.

Vlastnosti parametru

Typ:	PSApplicationGatewaySslCertificate
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResource

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-SslCertificateId

Určuje ID certifikátu SSL pro naslouchací proces HTTP.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResourceId

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-SslProfile

SslProfile

Vlastnosti parametru

Typ:	PSApplicationGatewaySslProfile
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResource

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-SslProfileId

SslProfileId

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResourceId

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

None

Výstupy

PSApplicationGatewayHttpListener

Související odkazy

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