Sdílet prostřednictvím

New-AzureRmWebAppSSLBinding

  • Reference
Modul:
AzureRM.Websites

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

Upozorňující

Modul AzureRM PowerShell byl od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.

I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.

Syntax

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

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

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

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
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:False
Accept wildcard characters:False

-CertificatePassword

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

Typ:String
Position:5
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Určuje název webové aplikace.

Typ:String
Position:3
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:False
Accept wildcard characters: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
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:False
Accept wildcard characters:False

-Slot

Určuje název slotu nasazení webové aplikace. K získání slotu můžete použít rutinu Get-AzureRMWebAppSlot. 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
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-SslState

Určuje, jestli je certifikát povolený. Nastavením parametru SSLState na hodnotu 1 povolte certifikát nebo nastavte sslState na hodnotu 0, aby se certifikát zakázal.

Typ:Nullable<T>[SslState]
přijímané hodnoty:Disabled, SniEnabled, IpBasedEnabled
Position:4
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-Thumbprint

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

Typ:String
Position:6
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:False
Accept wildcard characters:False

-WebApp

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

Typ:PSSite
Position:0
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:True
Accept wildcard characters: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
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

Site

Parametry: Webová aplikace (ByValue)

Výstupy

HostNameSslState