New-AzApplicationGatewayHttpListener
Создает прослушиватель HTTP для шлюза приложений.
Синтаксис
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>]
Описание
Командлет 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
Ошибка клиента шлюза приложений
Свойства параметров
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-DefaultProfile
Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.
Свойства параметров
Тип: IAzureContextContainer
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Aliases: AzContext, AzureRmContext, AzureCredential
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-FirewallPolicy
Указывает ссылку на объект для политики брандмауэра верхнего уровня.
Ссылку на объект можно создать с помощью командлета New-AzApplicationGatewayWebApplicationFirewallPolicy.
$firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name wafPolicy1 -ResourceGroup "rgName" Политика брандмауэра, созданная с помощью приведенного выше командлета, можно ссылаться на уровне правила пути.
В приведенной выше команде будут созданы параметры политики по умолчанию и управляемые правила.
Вместо значений по умолчанию пользователи могут указывать PolicySettings, ManagedRules с помощью New-AzApplicationGatewayFirewallPolicySettings и New-AzApplicationGatewayFirewallPolicyManagedRules соответственно.
Свойства параметров
Наборы параметров
SetByResource
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-FirewallPolicyId
Указывает идентификатор существующего ресурса брандмауэра веб-приложения верхнего уровня.
Идентификаторы политик брандмауэра можно возвращать с помощью командлета Get-AzApplicationGatewayWebApplicationFirewallPolicy.
После того как у нас есть идентификатор, можно использовать параметр FirewallPolicyId вместо параметра FirewallPolicy.
Например: -FirewallPolicyId "/subscriptions/<subscription-id>/resourceGroups/<resource-group-id>/providers/Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies/<firewallPolicyName>"
Свойства параметров
Тип: String
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
SetByResourceId
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-FrontendIPConfiguration
Задает объект конфигурации ВНЕШНЕГО IP-адреса для прослушивателя HTTP.
Свойства параметров
Наборы параметров
SetByResource
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-FrontendIPConfigurationId
Указывает идентификатор интерфейсной IP-конфигурации прослушивателя HTTP.
Свойства параметров
Тип: String
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
SetByResourceId
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-FrontendPort
Указывает интерфейсный порт для прослушивателя HTTP.
Свойства параметров
Наборы параметров
SetByResource
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-FrontendPortId
Указывает идентификатор объекта внешнего порта для прослушивателя HTTP.
Свойства параметров
Тип: String
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
SetByResourceId
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-HostName
Указывает имя узла прослушивателя HTTP шлюза приложений.
Свойства параметров
Тип: String
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-HostNames
Имена узлов
Свойства параметров
Тип: String [ ]
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-Name
Указывает имя прослушивателя HTTP, создаваемого этим командлетом.
Свойства параметров
Тип: String
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-Protocol
Указывает протокол, используемый прослушивателем HTTP.
Свойства параметров
Тип: String
Default value: None
Допустимые значения: Http, Https
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-RequireServerNameIndication
Командлет New-AzApplicationGatewayHttpListener создает прослушиватель HTTP для шлюза приложений Azure.
Свойства параметров
Тип: String
Default value: true
Допустимые значения: true, false
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
(All)
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-SslCertificate
Указывает объект SSL-сертификата для прослушивателя HTTP.
Свойства параметров
Наборы параметров
SetByResource
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-SslCertificateId
Указывает идентификатор SSL-сертификата для прослушивателя HTTP.
Свойства параметров
Тип: String
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
SetByResourceId
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-SslProfile
SslProfile
Свойства параметров
Наборы параметров
SetByResource
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-SslProfileId
SslProfileId
Свойства параметров
Тип: String
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
SetByResourceId
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters .
None
Выходные данные