New-AzureRmWebAppSSLBinding

  • Başvuru
Modül:
AzureRM.Websites

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

Uyarı

AzureRM PowerShell modülü 29 Şubat 2024 itibarıyla resmi olarak kullanım dışı bırakılmıştır. Kullanıcıların destek ve güncelleştirmelerin devam etmesini sağlamak için AzureRM'den Az PowerShell modülüne geçmeleri tavsiye edilir.

AzureRM modülü çalışmaya devam edebilir, ancak artık bakım yapılmaz veya desteklenmez ve kullanıcının takdirine ve riskine bağlı olarak sürekli kullanım sağlanır. Az modülüne geçiş konusunda yönergeler için lütfen geçiş kaynaklarımıza bakın.

Sözdizimi

New-AzureRmWebAppSSLBinding
   [-ResourceGroupName] <String>
   [-WebAppName] <String>
   [[-Slot] <String>]
   [-Name] <String>
   [[-SslState] <SslState>]
   [-CertificateFilePath] <String>
   [-CertificatePassword] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzureRmWebAppSSLBinding
   [-ResourceGroupName] <String>
   [-WebAppName] <String>
   [[-Slot] <String>]
   [-Name] <String>
   [[-SslState] <SslState>]
   [-Thumbprint] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzureRmWebAppSSLBinding
   [-WebApp] <PSSite>
   [-Name] <String>
   [[-SslState] <SslState>]
   [-CertificateFilePath] <String>
   [-CertificatePassword] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzureRmWebAppSSLBinding
   [-WebApp] <PSSite>
   [-Name] <String>
   [[-SslState] <SslState>]
   [-Thumbprint] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

New-AzureRmWebAppSSLBinding 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

PS C:\>New-AzureRmWebAppSSLBinding -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.

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

-DefaultProfile

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

Tür:IAzureContextContainer
Diğer adlar: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-AzureRMWebAppSlot 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-AzureRmWebApp 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

Girişler

Site

Parametreler: WebApp (ByValue)

Çıkışlar

HostNameSslState