Udostępnij za pośrednictwem

New-AzApplicationGatewayHttpListener

  • Odwołanie
Moduł:
Az.Network

Tworzy odbiornik HTTP dla bramy aplikacji.

Składnia

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

Opis

Polecenie cmdlet New-AzApplicationGatewayHttpListener tworzy odbiornik HTTP dla bramy aplikacji platformy Azure.

Przykłady

Przykład 1. Tworzenie odbiornika HTTP

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

To polecenie tworzy odbiornik HTTP o nazwie Listener01 i przechowuje wynik w zmiennej o nazwie $Listener.

Przykład 2. Tworzenie odbiornika HTTP przy użyciu protokołu SSL

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

To polecenie tworzy odbiornik HTTP, który używa odciążania PROTOKOŁU SSL i udostępnia certyfikat SSL w zmiennej $SSLCert 01. Polecenie przechowuje wynik w zmiennej o nazwie $Listener.

Przykład 3. Tworzenie odbiornika HTTP przy użyciu zasad zapory

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

To polecenie tworzy odbiornik HTTP o nazwie Listener01, FirewallPolicy jako $firewallPolicy i zapisuje wynik w zmiennej o nazwie $Listener.

Przykład 4. Dodawanie odbiornika HTTPS przy użyciu protokołów SSL i HostNames

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

To polecenie tworzy odbiornik HTTP, który używa odciążania SSL i udostępnia certyfikat SSL w zmiennej $SSLCert 01 wraz z dwoma nazwami hostów. Polecenie przechowuje wynik w zmiennej o nazwie $Listener.

Parametry

-CustomErrorConfiguration

Błąd klienta bramy aplikacji

Typ:PSApplicationGatewayCustomError[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-FirewallPolicy

Określa odwołanie do obiektu do zasad zapory najwyższego poziomu. Odwołanie do obiektu można utworzyć przy użyciu polecenia cmdlet New-AzApplicationGatewayWebApplicationFirewallPolicy. $firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name "wafPolicy1" -ResourceGroup "rgName" Zasady zapory utworzone przy użyciu powyższego polecenia polecenia można odwoływać się na poziomie reguły ścieżki. powyższe polecenie tworzy domyślne ustawienia zasad i zarządzane reguły. Zamiast wartości domyślnych użytkownicy mogą określić wartości PolicySettings, ManagedRules przy użyciu odpowiednio New-AzApplicationGatewayFirewallPolicySettings i New-AzApplicationGatewayFirewallPolicyManagedRules.

Typ:PSApplicationGatewayWebApplicationFirewallPolicy
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-FirewallPolicyId

Określa identyfikator istniejącego zasobu zapory aplikacji internetowej najwyższego poziomu. Identyfikatory zasad zapory można zwrócić przy użyciu polecenia cmdlet Get-AzApplicationGatewayWebApplicationFirewallPolicy. Po wprowadzeniu identyfikatora można użyć parametru FirewallPolicyId zamiast parametru FirewallPolicy. Na przykład: -FirewallPolicyId "/subscriptions/<subscription-id>/resourceGroups/<resource-group-id>/providers/Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies/<firewallPolicyName>"

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-FrontendIPConfiguration

Określa obiekt konfiguracji adresu IP frontonu dla odbiornika HTTP.

Typ:PSApplicationGatewayFrontendIPConfiguration
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-FrontendIPConfigurationId

Określa identyfikator konfiguracji adresu IP frontonu dla odbiornika HTTP.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-FrontendPort

Określa port frontonu dla odbiornika HTTP.

Typ:PSApplicationGatewayFrontendPort
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-FrontendPortId

Określa identyfikator obiektu portu frontonu dla odbiornika HTTP.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-HostName

Określa nazwę hosta odbiornika HTTP bramy aplikacji.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-HostNames

Nazwy hostów

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwę odbiornika HTTP tworzonego przez to polecenie cmdlet.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Protocol

Określa protokół używany przez odbiornik HTTP.

Typ:String
Dopuszczalne wartości:Http, Https
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RequireServerNameIndication

Typ:String
Dopuszczalne wartości:true, false
Position:Named
Domyślna wartość:true
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SslCertificate

Określa obiekt certyfikatu SSL dla odbiornika HTTP.

Typ:PSApplicationGatewaySslCertificate
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SslCertificateId

Określa identyfikator certyfikatu SSL dla odbiornika HTTP.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SslProfile

SslProfile

Typ:PSApplicationGatewaySslProfile
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SslProfileId

SslProfileId

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

None

Dane wyjściowe