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 コマンドレット 、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
アプリケーション ゲートウェイの顧客エラー
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named 必須: False パイプラインからの値: False プロパティ名別のパイプラインからの値: False 残りの引数からの値: False
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
パラメーターのプロパティ
型: IAzureContextContainer
規定値: None ワイルドカードのサポート: False DontShow: False Aliases: AzContext, AzureRmContext, AzureCredential
パラメーター セット
(All)
配置: Named 必須: False パイプラインからの値: False プロパティ名別のパイプラインからの値: False 残りの引数からの値: False
-FirewallPolicy
最上位レベルのファイアウォール ポリシーへのオブジェクト参照を指定します。
オブジェクト参照は、New-AzApplicationGatewayWebApplicationFirewallPolicy コマンドレットを使用して作成できます。
$firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name "wafPolicy1" -ResourceGroup "rgName" 上記のコマンドレットを使用して作成されたファイアウォール ポリシーは、パスルール レベルで参照できます。
上記のコマンドを実行すると、既定のポリシー設定と管理ルールが作成されます。
既定値の代わりに、New-AzApplicationGatewayFirewallPolicySettings と New-AzApplicationGatewayFirewallPolicyManagedRules をそれぞれ使用して、PolicySettings、ManagedRules を指定できます。
パラメーターのプロパティ
パラメーター セット
SetByResource
配置: Named 必須: False パイプラインからの値: 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
規定値: None ワイルドカードのサポート: False DontShow: False
パラメーター セット
SetByResourceId
配置: Named 必須: False パイプラインからの値: False プロパティ名別のパイプラインからの値: False 残りの引数からの値: False
-FrontendIPConfiguration
HTTP リスナーのフロントエンド IP 構成オブジェクトを指定します。
パラメーターのプロパティ
パラメーター セット
SetByResource
配置: Named 必須: False パイプラインからの値: False プロパティ名別のパイプラインからの値: False 残りの引数からの値: False
-FrontendIPConfigurationId
HTTP リスナーのフロントエンド IP 構成の ID を指定します。
パラメーターのプロパティ
型: String
規定値: None ワイルドカードのサポート: False DontShow: False
パラメーター セット
SetByResourceId
配置: Named 必須: False パイプラインからの値: False プロパティ名別のパイプラインからの値: False 残りの引数からの値: False
-FrontendPort
HTTP リスナーのフロントエンド ポートを指定します。
パラメーターのプロパティ
パラメーター セット
SetByResource
配置: Named 必須: False パイプラインからの値: False プロパティ名別のパイプラインからの値: False 残りの引数からの値: False
-FrontendPortId
HTTP リスナーのフロントエンド ポート オブジェクトの ID を指定します。
パラメーターのプロパティ
型: String
規定値: None ワイルドカードのサポート: False DontShow: False
パラメーター セット
SetByResourceId
配置: Named 必須: False パイプラインからの値: False プロパティ名別のパイプラインからの値: False 残りの引数からの値: False
-HostName
アプリケーション ゲートウェイ HTTP リスナーのホスト名を指定します。
パラメーターのプロパティ
型: String
規定値: None ワイルドカードのサポート: False DontShow: False
パラメーター セット
(All)
配置: Named 必須: False パイプラインからの値: False プロパティ名別のパイプラインからの値: False 残りの引数からの値: False
-HostNames
ホスト名
パラメーターのプロパティ
型: String [ ]
規定値: None ワイルドカードのサポート: False DontShow: False
パラメーター セット
(All)
配置: Named 必須: False パイプラインからの値: False プロパティ名別のパイプラインからの値: False 残りの引数からの値: False
-Name
このコマンドレットが作成する HTTP リスナーの名前を指定します。
パラメーターのプロパティ
型: String
規定値: None ワイルドカードのサポート: False DontShow: False
パラメーター セット
(All)
配置: Named 必須: True パイプラインからの値: False プロパティ名別のパイプラインからの値: False 残りの引数からの値: False
-Protocol
HTTP リスナーが使用するプロトコルを指定します。
パラメーターのプロパティ
型: String
規定値: None 指定可能な値: Http, Https ワイルドカードのサポート: False DontShow: False
パラメーター セット
(All)
配置: Named 必須: True パイプラインからの値: False プロパティ名別のパイプラインからの値: False 残りの引数からの値: False
-RequireServerNameIndication
New-AzApplicationGatewayHttpListener コマンドレット 、Azure アプリケーション ゲートウェイの HTTP リスナーを作成します。
パラメーターのプロパティ
型: String
規定値: true 指定可能な値: true, false ワイルドカードのサポート: False DontShow: False
パラメーター セット
(All)
配置: Named 必須: False パイプラインからの値: False プロパティ名別のパイプラインからの値: False 残りの引数からの値: False
-SslCertificate
HTTP リスナーの SSL 証明書オブジェクトを指定します。
パラメーターのプロパティ
パラメーター セット
SetByResource
配置: Named 必須: False パイプラインからの値: False プロパティ名別のパイプラインからの値: False 残りの引数からの値: False
-SslCertificateId
HTTP リスナーの SSL 証明書の ID を指定します。
パラメーターのプロパティ
型: String
規定値: None ワイルドカードのサポート: False DontShow: False
パラメーター セット
SetByResourceId
配置: Named 必須: False パイプラインからの値: False プロパティ名別のパイプラインからの値: False 残りの引数からの値: False
-SslProfile
SSLプロファイル
パラメーターのプロパティ
パラメーター セット
SetByResource
配置: Named 必須: False パイプラインからの値: False プロパティ名別のパイプラインからの値: False 残りの引数からの値: False
-SslProfileId
SslProfileId (英語)
パラメーターのプロパティ
型: String
規定値: None ワイルドカードのサポート: False DontShow: False
パラメーター セット
SetByResourceId
配置: Named 必須: False パイプラインからの値: False プロパティ名別のパイプラインからの値: False 残りの引数からの値: False
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParameters を参照してください。
None
出力
