Set-AzApplicationGatewayHttpListener
アプリケーション ゲートウェイの HTTP リスナーを変更します。
構文
Set-AzApplicationGatewayHttpListener
-ApplicationGateway <PSApplicationGateway>
-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>]
Set-AzApplicationGatewayHttpListener
-ApplicationGateway <PSApplicationGateway>
-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>]
説明
Set-AzApplicationGatewayHttpListener コマンドレットは、Azure アプリケーション ゲートウェイの HTTP リスナーを変更します。
例
例 1: HTTP リスナーを設定する
$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-AzApplicationGatewayHttpListener -ApplicationGateway $AppGw -Name "Listener01" -Protocol Http -FrontendIpConfiguration $FIP01 -FrontendPort 80
最初のコマンドは、ResourceGroup01 という名前のリソース グループに属する ApplicationGateway01 という名前のアプリケーション ゲートウェイを取得し、$AppGw変数に格納します。 2 番目のコマンドは、ポート 80 の HTTP プロトコルで $FIP 01 に格納されているフロントエンド構成を使用するようにゲートウェイの HTTP リスナーを設定します。
例 2: SSL と HostNames を使用して HTTPS リスナーを追加する
$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-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 リスナーを関連付けるアプリケーション ゲートウェイを指定します。
型: | PSApplicationGateway |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-CustomErrorConfiguration
アプリケーション ゲートウェイの顧客エラー
型: | PSApplicationGatewayCustomError[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
型: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-FirewallPolicy
FirewallPolicy
型: | PSApplicationGatewayWebApplicationFirewallPolicy |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-FirewallPolicyId
FirewallPolicyId
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-FrontendIPConfiguration
アプリケーション ゲートウェイのフロントエンド IP アドレスを指定します。
型: | PSApplicationGatewayFrontendIPConfiguration |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-FrontendIPConfigurationId
アプリケーション ゲートウェイのフロントエンド IP アドレスの ID を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-FrontendPort
アプリケーション ゲートウェイのフロントエンド ポートを指定します。
型: | PSApplicationGatewayFrontendPort |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-FrontendPortId
アプリケーション ゲートウェイのフロントエンド ポート 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 リスナーが使用するプロトコルを指定します。 このパラメーターの有効値は、次のとおりです。
- Http
- Https
型: | String |
指定可能な値: | Http, Https |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-RequireServerNameIndication
コマンドレットにサーバー名の表示が必要かどうかを指定します。 このパラメーターに使用できる値は true または false です。
型: | String |
指定可能な値: | true, false |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SslCertificate
HTTP リスナーの SSL 証明書を指定します。
型: | PSApplicationGatewaySslCertificate |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SslCertificateId
HTTP リスナーの Ssl (Secure Socket Layer) 証明書 ID を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SslProfile
SslProfile
型: | PSApplicationGatewaySslProfile |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SslProfileId
SslProfileId
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
出力
関連リンク
Azure PowerShell