Sdílet prostřednictvím

New-AzWebAppSSLBinding

  • Reference
Modul:
Az.Websites

Vytvoří vazbu certifikátu SSL pro webovou aplikaci Azure.

Syntaxe

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

Rutina New-AzWebAppSSLBinding vytvoří vazbu certifikátu SSL (Secure Socket Layer) pro webovou aplikaci Azure. Rutina vytvoří vazbu SSL dvěma způsoby:

  • Webovou aplikaci můžete svázat s existujícím certifikátem.
  • Můžete nahrát nový certifikát a pak vytvořit vazbu webové aplikace na tento nový certifikát. Bez ohledu na to, který přístup použijete, musí být certifikát a webová aplikace přidružené ke stejné skupině prostředků Azure. Pokud máte webovou aplikaci ve skupině prostředků A a chcete tuto webovou aplikaci svázat s certifikátem ve skupině prostředků B, jediným způsobem, jak to udělat, je nahrát kopii certifikátu do skupiny prostředků A. Pokud nahrajete nový certifikát, mějte na paměti následující požadavky na certifikát Azure SSL:
  • Certifikát musí obsahovat privátní klíč.
  • Certifikát musí používat formát PFX (Personal Information Exchange).
  • Název subjektu certifikátu se musí shodovat s doménou používanou pro přístup k webové aplikaci.
  • Certifikát musí používat minimálně 2048bitové šifrování.

Příklady

Příklad 1: Vytvoření vazby certifikátu k webové aplikaci

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

Tento příkaz vytvoří vazbu existujícího certifikátu Azure (certifikátu s kryptografickým otiskem E3A38EBA60CAA1C162785A2E1C44A15AD450199C3) k webové aplikaci s názvem ContosoWebApp.

Příklad 2

Vytvoří vazbu certifikátu SSL pro webovou aplikaci Azure. (automaticky vygenerováno)

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

PowerShell

Příklad 3

Vytvoří vazbu certifikátu SSL pro webovou aplikaci Azure. (automaticky vygenerováno)

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

Parametry

-CertificateFilePath

Určuje cestu k souboru pro certifikát, který se má nahrát. Parametr CertificateFilePath se vyžaduje jenom v případě, že se certifikát ještě nenahrál do Azure.

Typ:String
Position:4
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-CertificatePassword

Určuje heslo pro dešifrování certifikátu.

Typ:String
Position:5
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

Určuje název webové aplikace.

Typ:String
Position:3
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ResourceGroupName

Určuje název skupiny prostředků, ke které je certifikát přiřazen. Ve stejném příkazu nelze použít parametr ResourceGroupName a parametr WebApp.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Slot

Určuje název slotu nasazení webové aplikace. K získání slotu můžete použít rutinu Get-AzWebAppSlot. Sloty nasazení poskytují způsob, jak připravit a ověřit webové aplikace, aniž by tyto aplikace byly přístupné přes internet. Obvykle nasadíte změny do přípravného webu, ověříte je a pak nasadíte do produkčního webu (přístupného z internetu).

Typ:String
Position:2
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SslState

Určuje, jestli je certifikát povolený. Nastavte parametr SSLState na hodnotu 1, pokud chcete certifikát povolit, nebo nastavte SSLState na hodnotu 0, aby se certifikát zakázal.

Typ:Nullable<T>[SslState]
Přípustné hodnoty:Disabled, SniEnabled, IpBasedEnabled
Position:4
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Thumbprint

Určuje jedinečný identifikátor certifikátu.

Typ:String
Position:6
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WebApp

Určuje webovou aplikaci. K získání webové aplikace použijte rutinu Get-AzWebApp. Parametr webové aplikace nelze použít ve stejném příkazu jako parametr ResourceGroupName nebo WebAppName.

Typ:PSSite
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WebAppName

Určuje název webové aplikace, pro kterou se vytváří nová vazba SSL. Ve stejném příkazu nelze použít parametr WebAppName a parametr WebApp.

Typ:String
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

PSSite

Výstupy

HostNameSslState