New-AzApplicationGatewayHttpListener
アプリケーション ゲートウェイの 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
アプリケーション ゲートウェイの顧客エラー
| Type: | PSApplicationGatewayCustomError[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FirewallPolicy
最上位レベルのファイアウォール ポリシーへのオブジェクト参照を指定します。 オブジェクト参照は、New-AzApplicationGatewayWebApplicationFirewallPolicy コマンドレットを使用して作成できます。 $firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name "wafPolicy1" -ResourceGroup "rgName" 上記のコマンドレットを使用して作成されたファイアウォール ポリシーは、パス ルール レベルで参照できます。 上記のコマンドを実行すると、既定のポリシー設定と管理ルールが作成されます。 既定値の代わりに、ユーザーは、それぞれ New-AzApplicationGatewayFirewallPolicy設定 と New-AzApplicationGatewayFirewallPolicyManagedRules を使用して、Policy設定、ManagedRules を指定できます。
| Type: | PSApplicationGatewayWebApplicationFirewallPolicy |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FirewallPolicyId
既存のトップレベル Web アプリケーション ファイアウォール リソースの ID を指定します。
ファイアウォール ポリシー ID は、Get-AzApplicationGatewayWebApplicationFirewallPolicy コマンドレットを使用して返すことができます。
ID を取得したら、FirewallPolicy パラメーターの代わりに FirewallPolicyId パラメーターを使用できます。
例: -FirewallPolicyId "/subscriptions/<subscription-id>/resourceGroups/<resource-group-id>/providers/Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies/<firewallPolicyName>"
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FrontendIPConfiguration
HTTP リスナーのフロントエンド IP 構成オブジェクトを指定します。
| Type: | PSApplicationGatewayFrontendIPConfiguration |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FrontendIPConfigurationId
HTTP リスナーのフロントエンド IP 構成の ID を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FrontendPort
HTTP リスナーのフロントエンド ポートを指定します。
| Type: | PSApplicationGatewayFrontendPort |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FrontendPortId
HTTP リスナーのフロントエンド ポート オブジェクトの ID を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HostName
アプリケーション ゲートウェイ HTTP リスナーのホスト名を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HostNames
ホスト名
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
このコマンドレットが作成する HTTP リスナーの名前を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Protocol
HTTP リスナーが使用するプロトコルを指定します。
| Type: | String |
| Accepted values: | Http, Https |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RequireServerNameIndication
| Type: | String |
| Accepted values: | true, false |
| Position: | Named |
| Default value: | true |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SslCertificate
HTTP リスナーの SSL 証明書オブジェクトを指定します。
| Type: | PSApplicationGatewaySslCertificate |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SslCertificateId
HTTP リスナーの SSL 証明書の ID を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SslProfile
SslProfile
| Type: | PSApplicationGatewaySslProfile |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SslProfileId
SslProfileId
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
None
出力
PSApplicationGatewayHttpListener
関連リンク
Azure PowerShell
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示