New-AzApplicationGatewayHttpListener

モジュール:

Az.Network

アプリケーション ゲートウェイの 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 コマンドレットは、Azure アプリケーション ゲートウェイの HTTP リスナーを作成します。

例

例 1: HTTP リスナーを作成する

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

このコマンドは、Listener01 という名前の HTTP リスナーを作成し、結果を $Listener という名前の変数に格納します。

例 2: SSL を使用して HTTP リスナーを作成する

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

このコマンドは、SSL オフロードを使用する HTTP リスナーを作成し、$SSLCert 01 変数に SSL 証明書を提供します。 このコマンドは、結果を $Listener という名前の変数に格納します。

例 3: ファイアウォール ポリシーを使用して HTTP リスナーを作成する

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

このコマンドは、Listener01、FirewallPolicy という名前の HTTP リスナーを$firewallPolicyとして作成し、結果を $Listener という名前の変数に格納します。

例 4: SSL と HostNames を使用して HTTPS リスナーを追加する

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

このコマンドは、SSL オフロードを使用する HTTP リスナーを作成し、2 つの HostName と共に $SSLCert 01 変数に SSL 証明書を提供します。 このコマンドは、結果を $Listener という名前の変数に格納します。

パラメーター

-CustomErrorConfiguration

アプリケーション ゲートウェイの顧客エラー

型:	PSApplicationGatewayCustomError[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。

型:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-FirewallPolicy

最上位レベルのファイアウォール ポリシーへのオブジェクト参照を指定します。 オブジェクト参照は、New-AzApplicationGatewayWebApplicationFirewallPolicy コマンドレットを使用して作成できます。 $firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name "wafPolicy1" -ResourceGroup "rgName" 上記のコマンドレットを使用して作成されたファイアウォール ポリシーは、パス ルール レベルで参照できます。 上記のコマンドを実行すると、既定のポリシー設定と管理ルールが作成されます。 既定値の代わりに、New-AzApplicationGatewayFirewallPolicySettings と New-AzApplicationGatewayFirewallPolicyManagedRules をそれぞれ使用して、PolicySettings、ManagedRules を指定できます。

型:	PSApplicationGatewayWebApplicationFirewallPolicy
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-FirewallPolicyId

既存のトップレベル Web アプリケーション ファイアウォール リソースの ID を指定します。 ファイアウォール ポリシー ID は、Get-AzApplicationGatewayWebApplicationFirewallPolicy コマンドレットを使用して返すことができます。 ID を取得したら、FirewallPolicy パラメーターの代わりに FirewallPolicyId パラメーター使用できます。 例: -FirewallPolicyId "/subscriptions/<subscription-id>/resourceGroups/<resource-group-id>/providers/Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies/<firewallPolicyName>"

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-FrontendIPConfiguration

HTTP リスナーのフロントエンド IP 構成オブジェクトを指定します。

型:	PSApplicationGatewayFrontendIPConfiguration
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-FrontendIPConfigurationId

HTTP リスナーのフロントエンド IP 構成の ID を指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-FrontendPort

HTTP リスナーのフロントエンド ポートを指定します。

型:	PSApplicationGatewayFrontendPort
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-FrontendPortId

HTTP リスナーのフロントエンド ポート オブジェクトの ID を指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-HostName

アプリケーション ゲートウェイ HTTP リスナーのホスト名を指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-HostNames

ホスト名

型:	String[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Name

このコマンドレットが作成する HTTP リスナーの名前を指定します。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Protocol

HTTP リスナーが使用するプロトコルを指定します。

型:	String
指定可能な値:	Http, Https
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RequireServerNameIndication

型:	String
指定可能な値:	true, false
配置:	Named
規定値:	true
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SslCertificate

HTTP リスナーの SSL 証明書オブジェクトを指定します。

型:	PSApplicationGatewaySslCertificate
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SslCertificateId

HTTP リスナーの SSL 証明書の ID を指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SslProfile

SslProfile

型:	PSApplicationGatewaySslProfile
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SslProfileId

SslProfileId

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

None

出力

PSApplicationGatewayHttpListener

関連リンク

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