Dela via


New-AzWebAppSSLBinding

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

Syntax

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

Cmdleten New-AzWebAppSSLBinding 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

New-AzWebAppSSLBinding -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.

Exempel 2

Skapar en SSL-certifikatbindning för en Azure-webbapp. (automatiskt genererad)

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

powershell

Exempel 3

Skapar en SSL-certifikatbindning för en Azure-webbapp. (automatiskt genererad)

New-AzWebAppSSLBinding -CertificateFilePath <String> -CertificatePassword <String> -Name 'www.contoso.com' -ResourceGroupName 'ContosoResourceGroup' -SslState Disabled -WebAppName '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

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:None
Obligatorisk:False
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:AzContext, 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-AzWebAppSlot 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-AzWebApp. 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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

PSSite

Utdata

HostNameSslState