Share via

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

Type:PSApplicationGatewayCustomError[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FirewallPolicy

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

Type:PSApplicationGatewayWebApplicationFirewallPolicy
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 FirewallPolicyId. Na przykład: -FirewallPolicyId "/subscriptions/<subscription-id>/resourceGroups/<resource-group-id>/providers/Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies/<firewallPolicyName>"

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FrontendIPConfiguration

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

Type:PSApplicationGatewayFrontendIPConfiguration
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FrontendIPConfigurationId

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FrontendPort

Określa port frontonu dla odbiornika HTTP.

Type:PSApplicationGatewayFrontendPort
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FrontendPortId

Określa identyfikator obiektu portu frontonu dla odbiornika HTTP.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HostName

Określa nazwę hosta odbiornika HTTP bramy aplikacji.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HostNames

Nazwy hostów

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Protocol

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

Type:String
Accepted values:Http, Https
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RequireServerNameIndication

Type:String
Accepted values:true, false
Position:Named
Default value:true
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SslCertificate

Określa obiekt certyfikatu SSL dla odbiornika HTTP.

Type:PSApplicationGatewaySslCertificate
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SslCertificateId

Określa identyfikator certyfikatu SSL dla odbiornika HTTP.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SslProfile

SslProfile

Type:PSApplicationGatewaySslProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SslProfileId

SslProfileId

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

None

Dane wyjściowe

PSApplicationGatewayHttpListener