New-AzWebAppSSLBinding

  • Başvuru
Modül:
Az.Websites

Azure Web App için SSL sertifika bağlaması oluşturur.

Sözdizimi

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>]

Description

New-AzWebAppSSLBinding cmdlet'i bir Azure Web Uygulaması için Güvenli Yuva Katmanı (SSL) sertifika bağlaması oluşturur. cmdlet'i iki yolla bir SSL bağlaması oluşturur:

  • Web Uygulamasını var olan bir sertifikaya bağlayabilirsiniz.
  • Yeni bir sertifika yükleyip Web Uygulamasını bu yeni sertifikaya bağlayabilirsiniz. Hangi yaklaşımı kullanırsanız kullanın, sertifika ve Web Uygulaması aynı Azure kaynak grubuyla ilişkilendirilmelidir. A Kaynak Grubu'nda bir Web Uygulamanız varsa ve bu Web Uygulamasını B Kaynak Grubu'ndaki bir sertifikaya bağlamak istiyorsanız, bunun tek yolu sertifikanın bir kopyasını A Kaynak Grubu'na yüklemektir. Yeni bir sertifika yüklerseniz Azure SSL sertifikası için aşağıdaki gereksinimleri göz önünde bulundurun:
  • Sertifika bir özel anahtar içermelidir.
  • Sertifika Kişisel Bilgi Değişimi (PFX) biçimini kullanmalıdır.
  • Sertifikanın konu adı, Web Uygulamasına erişmek için kullanılan etki alanıyla eşleşmelidir.
  • Sertifika en az 2048 bit şifreleme kullanmalıdır.

Örnekler

Örnek 1: Web Uygulamasına sertifika bağlama

New-AzWebAppSSLBinding -ResourceGroupName "ContosoResourceGroup" -WebAppName "ContosoWebApp" -Thumbprint "E3A38EBA60CAA1C162785A2E1C44A15AD450199C3" -Name "www.contoso.com"

Bu komut, contosoWebApp adlı web uygulamasına var olan bir Azure sertifikasını (Parmak İzi E3A38EBA60CAA1C162785A2E1C44A15AD450199C3 içeren bir sertifika) bağlar.

Örnek 2

Azure Web App için SSL sertifika bağlaması oluşturur. (otomatik olarak oluşturulmuş)

New-AzWebAppSSLBinding -Name 'www.contoso.com' -ResourceGroupName 'ContosoResourceGroup' -SslState Disabled -Thumbprint 'E3A38EBA60CAA1C162785A2E1C44A15AD450199C3' -WebAppName 'ContosoWebApp'

powershell

Örnek 3

Azure Web App için SSL sertifika bağlaması oluşturur. (otomatik olarak oluşturulmuş)

New-AzWebAppSSLBinding -CertificateFilePath <String> -CertificatePassword <String> -Name 'www.contoso.com' -ResourceGroupName 'ContosoResourceGroup' -SslState Disabled -WebAppName 'ContosoWebApp'

Parametreler

-CertificateFilePath

Karşıya yüklenecek sertifikanın dosya yolunu belirtir. CertificateFilePath parametresi yalnızca sertifika henüz Azure'a yüklenmemişse gereklidir.

Tür:String
Position:4
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-CertificatePassword

Sertifikanın şifre çözme parolasını belirtir.

Tür:String
Position:5
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

Tür:IAzureContextContainer
Diğer adlar:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Name

Web Uygulamasının adını belirtir.

Tür:String
Position:3
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ResourceGroupName

Sertifikanın atandığı kaynak grubunun adını belirtir. ResourceGroupName parametresini ve WebApp parametresini aynı komutta kullanamazsınız.

Tür:String
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Slot

Web Uygulaması dağıtım yuvasının adını belirtir. Yuva almak için Get-AzWebAppSlot cmdlet'ini kullanabilirsiniz. Dağıtım yuvaları, web uygulamalarını internet üzerinden erişilebilir olmadan hazırlamanız ve doğrulamanız için bir yol sağlar. Normalde değişikliklerinizi bir hazırlama sitesine dağıtır, bu değişiklikleri doğrular ve ardından üretim (İnternet'e erişilebilir) sitesine dağıtırsınız.

Tür:String
Position:2
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-SslState

Sertifikanın etkinleştirilip etkinleştirilmediğini belirtir. Sertifikayı etkinleştirmek için SSLState parametresini 1 olarak veya sertifikayı devre dışı bırakmak için SSLState değerini 0 olarak ayarlayın.

Tür:Nullable<T>[SslState]
Kabul edilen değerler:Disabled, SniEnabled, IpBasedEnabled
Position:4
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Thumbprint

Sertifikanın benzersiz tanımlayıcısını belirtir.

Tür:String
Position:6
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-WebApp

Bir Web Uygulaması belirtir. Web Uygulaması almak için Get-AzWebApp cmdlet'ini kullanın. ResourceGroupName parametresi ve/veya WebAppName ile aynı komutta WebApp parametresini kullanamazsınız.

Tür:PSSite
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-WebAppName

Yeni SSL bağlamasının oluşturulduğu Web Uygulamasının adını belirtir. Aynı komutta WebAppName parametresini ve WebApp parametresini kullanamazsınız.

Tür:String
Position:1
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Tür:SwitchParameter
Diğer adlar:wi
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

PSSite

Çıkışlar

HostNameSslState