New-AzApplicationGatewayHttpListener
Создает прослушиватель HTTP для шлюза приложений.
Синтаксис
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>]
Описание
Командлет New-AzApplicationGatewayHttpListener создает прослушиватель HTTP для шлюза приложений Azure.
Примеры
Пример 1. Создание прослушивателя HTTP
$Listener = New-AzApplicationGatewayHttpListener -Name "Listener01" -Protocol "Http" -FrontendIpConfiguration $FIp01 -FrontendPort $FP01
Эта команда создает прослушиватель HTTP с именем Listener01 и сохраняет результат в переменной с именем $Listener.
Пример 2. Создание прослушивателя HTTP с помощью SSL
$Listener = New-AzApplicationGatewayHttpListener -Name "Listener01" -Protocol "Https" -FrontendIpConfiguration $FIp01 -FrontendPort $FP01 -SslCertificate $SSLCert01
Эта команда создает прослушиватель HTTP, использующий разгрузку SSL и предоставляющий SSL-сертификат в переменной $SSLCert 01. Команда сохраняет результат в переменной с именем $Listener.
Пример 3. Создание прослушивателя HTTP с помощью политики брандмауэра
$Listener = New-AzApplicationGatewayHttpListener -Name "Listener01" -Protocol "Http" -FrontendIpConfiguration $FIp01 -FrontendPort $FP01 -FirewallPolicy $firewallPolicy
Эта команда создает прослушиватель HTTP с именем Listener01, FirewallPolicy как $firewallPolicy и сохраняет результат в переменной с именем $Listener.
Пример 4. Добавление прослушивателя HTTPS с помощью SSL и HostNames
$Listener = New-AzApplicationGatewayHttpListener -Name "Listener01" -Protocol "Https" -FrontendIpConfiguration $FIp01 -FrontendPort $FP01 -SslCertificate $SSLCert01 -HostNames "*.contoso.com","www.microsoft.com"
Эта команда создает прослушиватель HTTP, использующий разгрузку SSL и предоставляющий SSL-сертификат в переменной $SSLCert 01 вместе с двумя именами узлов. Команда сохраняет результат в переменной с именем $Listener.
Параметры
-CustomErrorConfiguration
Ошибка клиента шлюза приложений
Тип: | PSApplicationGatewayCustomError[] |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-DefaultProfile
Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.
Тип: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-FirewallPolicy
Указывает ссылку на объект для политики брандмауэра верхнего уровня. Ссылку на объект можно создать с помощью командлета New-AzApplicationGatewayWebApplicationFirewallPolicy. $firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name wafPolicy1 -ResourceGroup "rgName" Политика брандмауэра, созданная с помощью приведенного выше командлета, можно ссылаться на уровне правила пути. В приведенной выше команде будут созданы параметры политики по умолчанию и управляемые правила. Вместо значений по умолчанию пользователи могут указывать PolicySettings, ManagedRules с помощью New-AzApplicationGatewayFirewallPolicySettings и New-AzApplicationGatewayFirewallPolicyManagedRules соответственно.
Тип: | PSApplicationGatewayWebApplicationFirewallPolicy |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-FirewallPolicyId
Указывает идентификатор существующего ресурса брандмауэра веб-приложения верхнего уровня.
Идентификаторы политик брандмауэра можно возвращать с помощью командлета Get-AzApplicationGatewayWebApplicationFirewallPolicy.
После того как у нас есть идентификатор, можно использовать параметр FirewallPolicyIdвместо параметра брандмауэра FirewallPolicy.
Например: -FirewallPolicyId "/subscriptions/<subscription-id>/resourceGroups/<resource-group-id>/providers/Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies/<firewallPolicyName>"
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-FrontendIPConfiguration
Задает объект конфигурации ВНЕШНЕГО IP-адреса для прослушивателя HTTP.
Тип: | PSApplicationGatewayFrontendIPConfiguration |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-FrontendIPConfigurationId
Указывает идентификатор интерфейсной IP-конфигурации прослушивателя HTTP.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-FrontendPort
Указывает интерфейсный порт для прослушивателя HTTP.
Тип: | PSApplicationGatewayFrontendPort |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-FrontendPortId
Указывает идентификатор объекта внешнего порта для прослушивателя HTTP.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-HostName
Указывает имя узла прослушивателя HTTP шлюза приложений.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-HostNames
Имена узлов
Тип: | String[] |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Name
Указывает имя прослушивателя HTTP, создаваемого этим командлетом.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Protocol
Указывает протокол, используемый прослушивателем HTTP.
Тип: | String |
Допустимые значения: | Http, Https |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-RequireServerNameIndication
Тип: | String |
Допустимые значения: | true, false |
Position: | Named |
Default value: | true |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-SslCertificate
Указывает объект SSL-сертификата для прослушивателя HTTP.
Тип: | PSApplicationGatewaySslCertificate |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-SslCertificateId
Указывает идентификатор SSL-сертификата для прослушивателя HTTP.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-SslProfile
SslProfile
Тип: | PSApplicationGatewaySslProfile |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-SslProfileId
SslProfileId
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Входные данные
None
Выходные данные
PSApplicationGatewayHttpListener
Связанные ссылки
Azure PowerShell