New-AzWebAppSSLBinding

  • Referens
Modul:
Az.Websites

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.

Type:String
Position:4
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-CertificatePassword

Anger dekrypteringslösenordet för certifikatet.

Type:String
Position:5
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Anger namnet på webbappen.

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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).

Type:String
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Nullable<T>[SslState]
Accepted values:Disabled, SniEnabled, IpBasedEnabled
Position:4
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Thumbprint

Anger den unika identifieraren för certifikatet.

Type:String
Position:6
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:PSSite
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Indata

PSSite

Utdata

HostNameSslState