Set-AzApplicationGatewayHttpListener

Memodifikasi pendengar HTTP untuk gateway aplikasi.

Sintaks

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>]
    [-AcquirePolicyToken]
    [-ChangeReference <String>]
    [<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>]
    [-AcquirePolicyToken]
    [-ChangeReference <String>]
    [<CommonParameters>]

Deskripsi

Cmdlet Set-AzApplicationGatewayHttpListener memodifikasi pendengar HTTP untuk gateway aplikasi Azure.

Contoh

Contoh 1: Mengatur pendengar HTTP

$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-AzApplicationGatewayHttpListener -ApplicationGateway $AppGw -Name "Listener01" -Protocol Http -FrontendIpConfiguration $FIP01 -FrontendPort 80

Perintah pertama mendapatkan gateway aplikasi bernama ApplicationGateway01 yang termasuk dalam grup sumber daya bernama ResourceGroup01 dan menyimpannya dalam variabel $AppGw. Perintah kedua mengatur pendengar HTTP untuk gateway agar menggunakan konfigurasi front-end yang disimpan di $FIP 01 dengan protokol HTTP pada port 80.

Contoh 2: Menambahkan pendengar HTTPS dengan SSL dan HostNames

$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"

Perintah pertama mendapatkan gateway aplikasi dan menyimpannya dalam variabel $AppGw. Perintah kedua menambahkan listener, yang menggunakan protokol HTTPS, dengan Sertifikat SSL dan HostNames, ke gateway aplikasi.

Parameter

-AcquirePolicyToken

Dapatkan token Azure Policy secara otomatis untuk operasi sumber daya ini.

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-ApplicationGateway

Menentukan gateway aplikasi tempat cmdlet ini mengaitkan pendengar HTTP.

Properti parameter

Jenis:PSApplicationGateway
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:True
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-ChangeReference

ID sumber daya referensi perubahan untuk operasi sumber daya ini.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-CustomErrorConfiguration

Kesalahan pelanggan gateway aplikasi

Properti parameter

Jenis:

PSApplicationGatewayCustomError[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan azure.

Properti parameter

Jenis:IAzureContextContainer
Nilai default:None
Mendukung wildcard:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-FirewallPolicy

Kebijakan Firewall

Properti parameter

Jenis:PSApplicationGatewayWebApplicationFirewallPolicy
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

SetByResource
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-FirewallPolicyId

FirewallPolicyId

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

SetByResourceId
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-FrontendIPConfiguration

Menentukan alamat IP front-end gateway aplikasi.

Properti parameter

Jenis:PSApplicationGatewayFrontendIPConfiguration
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

SetByResource
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-FrontendIPConfigurationId

Menentukan ID alamat IP front-end gateway aplikasi.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

SetByResourceId
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-FrontendPort

Menentukan port front-end gateway aplikasi.

Properti parameter

Jenis:PSApplicationGatewayFrontendPort
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

SetByResource
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-FrontendPortId

Menentukan ID port front-end gateway aplikasi.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

SetByResourceId
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-HostName

Menentukan nama host tempat cmdlet ini mengirim pendengar HTTP.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-HostNames

Nama host

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Name

Menentukan nama pendengar HTTP.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Protocol

Menentukan protokol yang digunakan pendengar HTTP. Nilai yang dapat diterima untuk parameter ini adalah:

  • http
  • Https

Properti parameter

Jenis:String
Nilai default:None
Nilai yang diterima:Http, Https
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-RequireServerNameIndication

Menentukan apakah cmdlet memerlukan indikasi nama server. Nilai yang dapat diterima untuk parameter ini adalah: benar atau salah.

Properti parameter

Jenis:String
Nilai default:None
Nilai yang diterima:true, false
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-SslCertificate

Menentukan sertifikat SSL pendengar HTTP.

Properti parameter

Jenis:PSApplicationGatewaySslCertificate
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

SetByResource
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-SslCertificateId

Menentukan ID sertifikat Secure Socket Layer (SSL) pendengar HTTP.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

SetByResourceId
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-SslProfile

SslProfile

Properti parameter

Jenis:PSApplicationGatewaySslProfile
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

SetByResource
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-SslProfileId

SslProfileId

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

SetByResourceId
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

PSApplicationGateway

Output

PSApplicationGateway