Bagikan melalui

New-AzWebAppSSLBinding

  • Referensi
Modul:
Az.Websites

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
Accept pipeline input:False
Accept wildcard characters:False

-CertificatePassword

Menentukan kata sandi dekripsi untuk sertifikat.

Jenis:String
Position:5
nilai default:None
Diperlukan:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Jenis:SwitchParameter
Aliases:cf
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Jenis:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Menentukan nama Aplikasi Web.

Jenis:String
Position:3
nilai default:None
Diperlukan:True
Accept pipeline input:False
Accept wildcard characters: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
Accept pipeline input:False
Accept wildcard characters: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
Accept pipeline input:False
Accept wildcard characters: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
Accept pipeline input:False
Accept wildcard characters:False

-Thumbprint

Menentukan pengidentifikasi unik untuk sertifikat.

Jenis:String
Position:6
nilai default:None
Diperlukan:True
Accept pipeline input:False
Accept wildcard characters: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
Accept pipeline input:True
Accept wildcard characters: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
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Jenis:SwitchParameter
Aliases:wi
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

Input

PSSite

Output

HostNameSslState