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>] Description
Set-AzApplicationGatewayHttpListener Cmdlet 會修改 Azure 應用程式閘道的 HTTP 接聽程式。
範例
範例 1：設定 HTTP 接聽程式
$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-AzApplicationGatewayHttpListener -ApplicationGateway $AppGw -Name "Listener01" -Protocol Http -FrontendIpConfiguration $FIP01 -FrontendPort 80第一個命令會取得名為 ApplicationGateway01 的應用程式閘道，該閘道屬於名為 ResourceGroup01 的資源群組，並將它儲存在$AppGw變數中。 第二個命令會設定閘道的 HTTP 接聽程式，以使用儲存在 $FIP 01 中的前端組態搭配埠 80 上的 HTTP 通訊協定。
範例 2：使用 SSL 和 HostName 新增 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變數中。 第二個命令會將使用 HTTPS 通訊協定與 SSL 憑證和主機名的接聽程式新增至應用程式閘道。
參數
-ApplicationGateway
指定此 Cmdlet 與 HTTP 接聽程式建立關聯的應用程式閘道。
| 類型: | PSApplicationGateway |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-CustomErrorConfiguration
應用程式閘道的客戶錯誤
| 類型: | PSApplicationGatewayCustomError[] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。
| 類型: | IAzureContextContainer |
| 別名: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-FirewallPolicy
FirewallPolicy
| 類型: | PSApplicationGatewayWebApplicationFirewallPolicy |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-FirewallPolicyId
FirewallPolicyId
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-FrontendIPConfiguration
指定應用程式閘道的前端IP位址。
| 類型: | PSApplicationGatewayFrontendIPConfiguration |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-FrontendIPConfigurationId
指定應用程式閘道前端IP位址的識別碼。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-FrontendPort
指定應用程式閘道前埠。
| 類型: | PSApplicationGatewayFrontendPort |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-FrontendPortId
指定應用程式閘道前埠識別碼。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-HostName
指定這個 Cmdlet 傳送 HTTP 接聽程式的主機名。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-HostNames
主機名稱
| 類型: | String[] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Name
指定 HTTP 接聽程式的名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Protocol
指定 HTTP 接聽程式所使用的通訊協定。 此參數可接受的值為：
- Http
- Https
| 類型: | String |
| 接受的值: | Http, Https |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-RequireServerNameIndication
指定 Cmdlet 是否需要伺服器名稱指示。 此參數可接受的值為：true 或 false。
| 類型: | String |
| 接受的值: | true, false |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SslCertificate
指定 HTTP 接聽程式的 SSL 憑證。
| 類型: | PSApplicationGatewaySslCertificate |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SslCertificateId
指定 HTTP 接聽程式的安全套接字層 （SSL） 憑證標識碼。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SslProfile
SslProfile
| 類型: | PSApplicationGatewaySslProfile |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SslProfileId
SslProfileId
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |