Dela via

New-AzureRmWebAppSSLBinding

  • Referens
Modul:
AzureRM.Websites

Skapar en SSL-certifikatbindning för en Azure-webbapp.

Varning

AzureRM PowerShell-modulen är officiellt inaktuell från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.

Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.

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

Cmdleten New-AzureRmWebAppSSLBinding skapar en SSL-certifikatbindning (Secure Socket Layer) för en Azure-webbapp. Cmdleten skapar en SSL-bindning på två sätt:

  • Du kan binda en webbapp till ett befintligt certifikat.
  • Du kan ladda upp ett nytt certifikat och sedan binda webbappen till det nya certifikatet. Oavsett vilken metod du använder måste certifikatet och webbappen associeras med samma Azure-resursgrupp. Om du har en webbapp i resursgrupp A och vill binda webbappen till ett certifikat i resursgrupp B är det enda sättet att göra det att ladda upp en kopia av certifikatet till resursgrupp A. Om du laddar upp ett nytt certifikat bör du tänka på följande krav för ett Azure SSL-certifikat:
  • Certifikatet måste innehålla en privat nyckel.
  • Certifikatet måste använda PFX-formatet (Personal Information Exchange).
  • Certifikatets ämnesnamn måste matcha domänen som används för att komma åt webbappen.
  • Certifikatet måste använda minst 2048-bitars kryptering.

Exempel

Exempel 1: Binda ett certifikat till en webbapp

PS C:\>New-AzureRmWebAppSSLBinding -ResourceGroupName "ContosoResourceGroup" -WebAppName "ContosoWebApp" -Thumbprint "E3A38EBA60CAA1C162785A2E1C44A15AD450199C3" -Name "www.contoso.com"

Det här kommandot binder ett befintligt Azure-certifikat (ett certifikat med Tumavtryck E3A38EBA60CAA1C162785A2E1C44A15AD450199C3) till webbappen med namnet ContosoWebApp.

Parametrar

-CertificateFilePath

Anger filsökvägen för certifikatet som ska laddas upp. Parametern CertificateFilePath krävs bara om certifikatet ännu inte har laddats upp till Azure.

Typ:String
Position:4
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-CertificatePassword

Anger dekrypteringslösenordet för certifikatet.

Typ:String
Position:5
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Name

Anger namnet på webbappen.

Typ:String
Position:3
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ResourceGroupName

Anger namnet på den resursgrupp som certifikatet har tilldelats till. Du kan inte använda parametern ResourceGroupName och webappparametern i samma kommando.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Slot

Anger namnet på webbappens distributionsfack. Du kan använda cmdleten Get-AzureRMWebAppSlot för att hämta ett fack. Distributionsfack är ett sätt för dig att mellanlagra och validera webbappar utan att dessa appar är tillgängliga via Internet. Vanligtvis distribuerar du ändringarna till en mellanlagringsplats, validerar ändringarna och distribuerar sedan till produktionsplatsen (internettillgänglig).

Typ:String
Position:2
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SslState

Anger om certifikatet är aktiverat. Ange SSLState-parametern till 1 för att aktivera certifikatet eller ange SSLState till 0 för att inaktivera certifikatet.

Typ:Nullable<T>[SslState]
Godkända värden:Disabled, SniEnabled, IpBasedEnabled
Position:4
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Thumbprint

Anger den unika identifieraren för certifikatet.

Typ:String
Position:6
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WebApp

Anger en webbapp. Om du vill hämta en webbapp använder du cmdleten Get-AzureRmWebApp. Du kan inte använda parametern WebApp i samma kommando som parametern ResourceGroupName och/eller WebAppName.

Typ:PSSite
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WebAppName

Anger namnet på webbappen som den nya SSL-bindningen skapas för. Du kan inte använda parametern WebAppName och webappparametern i samma kommando.

Typ:String
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

Site

Parametrar: WebApp (ByValue)

Utdata

HostNameSslState