次の方法で共有


Set-AzApplicationGatewayHttpListener

アプリケーション ゲートウェイの HTTP リスナーを変更します。

構文

SetByResourceId

Set-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

Set-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>]

説明

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
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-CustomErrorConfiguration

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

パラメーターのプロパティ

型:

PSApplicationGatewayCustomError[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-DefaultProfile

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

パラメーターのプロパティ

型:IAzureContextContainer
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-FirewallPolicy

ファイアウォールポリシー

パラメーターのプロパティ

型:PSApplicationGatewayWebApplicationFirewallPolicy
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

SetByResource
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-FirewallPolicyId

FirewallPolicyId

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

SetByResourceId
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-FrontendIPConfiguration

アプリケーション ゲートウェイのフロントエンド IP アドレスを指定します。

パラメーターのプロパティ

型:PSApplicationGatewayFrontendIPConfiguration
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

SetByResource
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-FrontendIPConfigurationId

アプリケーション ゲートウェイのフロントエンド IP アドレスの ID を指定します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

SetByResourceId
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-FrontendPort

アプリケーション ゲートウェイのフロントエンド ポートを指定します。

パラメーターのプロパティ

型:PSApplicationGatewayFrontendPort
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

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

HTTP リスナーの名前を指定します。

パラメーターのプロパティ

型: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

コマンドレットにサーバー名の表示が必要かどうかを指定します。 このパラメーターに使用できる値は true または false です。

パラメーターのプロパティ

型:String
規定値:None
指定可能な値:true, false
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-SslCertificate

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

パラメーターのプロパティ

型:PSApplicationGatewaySslCertificate
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

SetByResource
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-SslCertificateId

HTTP リスナーの Ssl (Secure Socket Layer) 証明書 ID を指定します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

SetByResourceId
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-SslProfile

SslProfile

パラメーターのプロパティ

型:PSApplicationGatewaySslProfile
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

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を参照してください。

入力

PSApplicationGateway

出力

PSApplicationGateway