New-AzWebAppSSLBinding
Membuat pengikatan sertifikat SSL untuk Azure Web App.
Sintaks
New-AzWebAppSSLBinding
[-ResourceGroupName] <String>
[-WebAppName] <String>
[[-Slot] <String>]
[-Name] <String>
[[-SslState] <SslState>]
[-CertificateFilePath] <String>
[-CertificatePassword] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzWebAppSSLBinding
[-ResourceGroupName] <String>
[-WebAppName] <String>
[[-Slot] <String>]
[-Name] <String>
[[-SslState] <SslState>]
[-Thumbprint] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzWebAppSSLBinding
[-WebApp] <PSSite>
[-Name] <String>
[[-SslState] <SslState>]
[-CertificateFilePath] <String>
[-CertificatePassword] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzWebAppSSLBinding
[-WebApp] <PSSite>
[-Name] <String>
[[-SslState] <SslState>]
[-Thumbprint] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Deskripsi
Cmdlet New-AzWebAppSSLBinding membuat pengikatan sertifikat Secure Socket Layer (SSL) untuk Azure Web App. Cmdlet membuat pengikatan SSL dengan dua cara:
- Anda dapat mengikat Aplikasi Web ke sertifikat yang sudah ada.
- Anda dapat mengunggah sertifikat baru lalu mengikat Aplikasi Web ke sertifikat baru ini. Terlepas dari pendekatan mana yang Anda gunakan, sertifikat dan Aplikasi Web harus dikaitkan dengan grup sumber daya Azure yang sama. Jika Anda memiliki Aplikasi Web di Grup Sumber Daya A dan Anda ingin mengikat Aplikasi Web tersebut ke sertifikat di Grup Sumber Daya B, satu-satunya cara untuk melakukannya adalah dengan mengunggah salinan sertifikat ke Grup Sumber Daya A. Jika Anda mengunggah sertifikat baru, ingatlah persyaratan berikut untuk sertifikat Azure SSL:
- Sertifikat harus memuat kunci privat.
- Sertifikat harus menggunakan format Pertukaran Informasi Pribadi (PFX).
- Nama subjek sertifikat harus cocok dengan domain yang digunakan untuk mengakses Aplikasi Web.
- Sertifikat harus menggunakan minimal enkripsi 2048-bit.
Contoh
Contoh 1: Mengikat sertifikat ke Aplikasi Web
New-AzWebAppSSLBinding -ResourceGroupName "ContosoResourceGroup" -WebAppName "ContosoWebApp" -Thumbprint "E3A38EBA60CAA1C162785A2E1C44A15AD450199C3" -Name "www.contoso.com"
Perintah ini mengikat sertifikat Azure yang ada (sertifikat dengan Thumbprint E3A38EBA60CAA1C162785A2E1C44A15AD450199C3) ke aplikasi web bernama ContosoWebApp.
Contoh 2
Membuat pengikatan sertifikat SSL untuk Azure Web App. (dibuat otomatis)
New-AzWebAppSSLBinding -Name 'www.contoso.com' -ResourceGroupName 'ContosoResourceGroup' -SslState Disabled -Thumbprint 'E3A38EBA60CAA1C162785A2E1C44A15AD450199C3' -WebAppName 'ContosoWebApp'
powershell
Contoh 3
Membuat pengikatan sertifikat SSL untuk Azure Web App. (dibuat otomatis)
New-AzWebAppSSLBinding -CertificateFilePath <String> -CertificatePassword <String> -Name 'www.contoso.com' -ResourceGroupName 'ContosoResourceGroup' -SslState Disabled -WebAppName 'ContosoWebApp'
Parameter
-CertificateFilePath
Menentukan jalur file untuk sertifikat yang akan diunggah. Parameter CertificateFilePath hanya diperlukan jika sertifikat belum diunggah ke Azure.
Jenis: | String |
Position: | 4 |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | False |
Terima karakter wildcard: | False |
-CertificatePassword
Menentukan kata sandi dekripsi untuk sertifikat.
Jenis: | String |
Position: | 5 |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Confirm
Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.
Jenis: | SwitchParameter |
Alias: | cf |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-DefaultProfile
Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan azure.
Jenis: | IAzureContextContainer |
Alias: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Name
Menentukan nama Aplikasi Web.
Jenis: | String |
Position: | 3 |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | False |
Terima karakter wildcard: | False |
-ResourceGroupName
Menentukan nama grup sumber daya tempat sertifikat ditetapkan. Anda tidak dapat menggunakan parameter ResourceGroupName dan parameter WebApp dalam perintah yang sama.
Jenis: | String |
Position: | 0 |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Slot
Menentukan nama slot penyebaran Aplikasi Web. Anda dapat menggunakan cmdlet Get-AzWebAppSlot untuk mendapatkan slot. Slot penyebaran menyediakan cara bagi Anda untuk menggelar dan memvalidasi aplikasi web tanpa aplikasi tersebut dapat diakses melalui Internet. Biasanya Anda akan menyebarkan perubahan Anda ke situs penahapan, memvalidasi perubahan tersebut, lalu menyebarkan ke situs produksi (dapat diakses Internet).
Jenis: | String |
Position: | 2 |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-SslState
Menentukan apakah sertifikat diaktifkan. Atur parameter SSLState ke 1 untuk mengaktifkan sertifikat, atau atur SSLState ke 0 untuk menonaktifkan sertifikat.
Jenis: | Nullable<T>[SslState] |
Nilai yang diterima: | Disabled, SniEnabled, IpBasedEnabled |
Position: | 4 |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Thumbprint
Menentukan pengidentifikasi unik untuk sertifikat.
Jenis: | String |
Position: | 6 |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | False |
Terima karakter wildcard: | False |
-WebApp
Menentukan Aplikasi Web. Untuk mendapatkan Aplikasi Web, gunakan cmdlet Get-AzWebApp. Anda tidak dapat menggunakan parameter WebApp dalam perintah yang sama dengan parameter ResourceGroupName dan/atau WebAppName.
Jenis: | PSSite |
Position: | 0 |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | True |
Terima karakter wildcard: | False |
-WebAppName
Menentukan nama Aplikasi Web tempat pengikatan SSL baru sedang dibuat. Anda tidak dapat menggunakan parameter WebAppName dan parameter WebApp dalam perintah yang sama.
Jenis: | String |
Position: | 1 |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | False |
Terima karakter wildcard: | False |
-WhatIf
Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.
Jenis: | SwitchParameter |
Alias: | wi |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |