Add-AzApplicationGatewayHttpListener
アプリケーション ゲートウェイに HTTP リスナーを追加します。
構文
SetByResourceId
Add-AzApplicationGatewayHttpListener
-ApplicationGateway <PSApplicationGateway>
-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
Add-AzApplicationGatewayHttpListener
-ApplicationGateway <PSApplicationGateway>
-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>]
説明
Add-AzApplicationGatewayHttpListener コマンドレットは、アプリケーション ゲートウェイに HTTP リスナーを追加します。
例
例 1: HTTP リスナーを追加する
$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$Appgw = Add-AzApplicationGatewayHttpListener -ApplicationGateway $AppGw -Name "listener01" -Protocol "Http" -FrontendIpConfiguration $FIP01 -FrontendPort $FP01
最初のコマンドは、アプリケーション ゲートウェイを取得し、$AppGw変数に格納します。2 番目のコマンドは、HTTP リスナーをアプリケーション ゲートウェイに追加します。
例 2: SSL を使用して HTTPS リスナーを追加する
$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Add-AzApplicationGatewayHttpListener -ApplicationGateway $AppGw -Name "Listener01" -Protocol "Https" -FrontendIpConfiguration $FIP01 -FrontendPort $FP01 -SslCertificate $SSLCert01
最初のコマンドは、アプリケーション ゲートウェイを取得し、$AppGw変数に格納します。
2 番目のコマンドは、HTTPS プロトコルを使用するリスナーをアプリケーション ゲートウェイに追加します。
例 3: SSL と HostNames を使用して HTTPS リスナーを追加する
$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Add-AzApplicationGatewayHttpListener -ApplicationGateway $AppGw -Name "Listener01" -Protocol "Https" -FrontendIpConfiguration $FIP01 -FrontendPort $FP01 -SslCertificate $SSLCert01 -HostNames "*.contoso.com","www.microsoft.com"
最初のコマンドは、アプリケーション ゲートウェイを取得し、$AppGw変数に格納します。
2 番目のコマンドは、HTTPS プロトコルを使用するリスナーを SSL 証明書と HostNames と共にアプリケーション ゲートウェイに追加します。
パラメーター
-ApplicationGateway
このコマンドレットが HTTP リスナーを追加するアプリケーション ゲートウェイを指定します。
パラメーターのプロパティ
パラメーター セット
(All)
配置: | Named |
必須: | True |
パイプラインからの値: | True |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-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
FirewallPolicy
パラメーターのプロパティ
パラメーター セット
SetByResource
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-FirewallPolicyId
ファイアウォールポリシーID
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
SetByResourceId
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-FrontendIPConfiguration
アプリケーション ゲートウェイのフロントエンド IP リソース オブジェクトを指定します。
パラメーターのプロパティ
パラメーター セット
SetByResource
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-FrontendIPConfigurationId
アプリケーション ゲートウェイのフロントエンド IP ID を指定します。
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
SetByResourceId
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-FrontendPort
アプリケーション ゲートウェイのフロントエンド ポート オブジェクトを指定します。
パラメーターのプロパティ
パラメーター セット
SetByResource
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-FrontendPortId
アプリケーション ゲートウェイのフロントエンド ポート 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
このコマンドが追加するフロントエンド ポートの名前を指定します。
パラメーターのプロパティ
型: | String
|
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | True |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Protocol
HTTP リスナーのプロトコルを指定します。
HTTP と HTTPS の両方がサポートされています。
パラメーターのプロパティ
型: | String
|
規定値: | None |
指定可能な値: | Http, Https |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | True |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-RequireServerNameIndication
Add-AzApplicationGatewayHttpListener コマンドレットは、アプリケーション ゲートウェイに HTTP リスナーを追加します。
パラメーターのプロパティ
型: | String
|
規定値: | None |
指定可能な値: | true, false |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-SslCertificate
HTTP リスナーの SSL 証明書を指定します。
HTTPS がリスナー プロトコルとして選択されている場合は、指定する必要があります。
パラメーターのプロパティ
パラメーター セット
SetByResource
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-SslCertificateId
HTTP リスナーの SSL 証明書 ID を指定します。
HTTPS がリスナー プロトコルとして選択されている場合は、指定する必要があります。
パラメーターのプロパティ
型: | 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を参照してください。
出力