New-AzWebAppSSLBinding

  • Riferimento
Modulo:
Az.Websites

Crea un'associazione di certificati SSL per un'app Web di Azure.

Sintassi

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>]

Descrizione

Il cmdlet New-AzWebAppSSLBinding crea un'associazione di certificati SSL (Secure Socket Layer) per un'app Web di Azure. Il cmdlet crea un'associazione SSL in due modi:

  • È possibile associare un'app Web a un certificato esistente.
  • È possibile caricare un nuovo certificato e quindi associare l'app Web a questo nuovo certificato. Indipendentemente dall'approccio usato, il certificato e l'app Web devono essere associati allo stesso gruppo di risorse di Azure. Se si dispone di un'app Web nel gruppo di risorse A e si vuole associare tale app Web a un certificato nel gruppo di risorse B, l'unico modo per eseguire questa operazione consiste nel caricare una copia del certificato nel gruppo di risorse A. Se si carica un nuovo certificato, tenere presente i requisiti seguenti per un certificato SSL di Azure:
  • Il certificato deve includere una chiave privata.
  • Il certificato deve utilizzare il formato PFX (Personal Information Exchange).
  • Il nome soggetto del certificato deve corrispondere al dominio usato per accedere all'app Web.
  • Per il certificato deve essere usata una crittografia di almeno 2048 bit.

Esempio

Esempio 1: Associare un certificato a un'app Web

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

Questo comando associa un certificato di Azure esistente (un certificato con l'identificazione personale E3A38EBA60CAA1C162785A2E1C44A15AD450199C3) all'app Web denominata ContosoWebApp.

Esempio 2

Crea un'associazione di certificati SSL per un'app Web di Azure. (generato automaticamente)

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

powershell

Esempio 3

Crea un'associazione di certificati SSL per un'app Web di Azure. (generato automaticamente)

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

Parametri

-CertificateFilePath

Specifica il percorso del file per il certificato da caricare. Il parametro CertificateFilePath è obbligatorio solo se il certificato non è ancora stato caricato in Azure.

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

-CertificatePassword

Specifica la password di decrittografia per il certificato.

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

-Confirm

Richiede conferma prima di eseguire il cmdlet.

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

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

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

-Name

Specifica il nome dell'app Web.

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

-ResourceGroupName

Specifica il nome del gruppo di risorse a cui è assegnato il certificato. Non è possibile usare il parametro ResourceGroupName e il parametro WebApp nello stesso comando.

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

-Slot

Specifica il nome dello slot di distribuzione dell'app Web. È possibile usare il cmdlet Get-AzWebAppSlot per ottenere uno slot. Gli slot di distribuzione consentono di preparare e convalidare le app Web senza che tali app siano accessibili tramite Internet. In genere si distribuiranno le modifiche in un sito di staging, le modifiche verranno convalidate e quindi distribuite nel sito di produzione (accessibile da Internet).

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

-SslState

Specifica se il certificato è abilitato. Impostare il parametro SSLState su 1 per abilitare il certificato o impostare SSLState su 0 per disabilitare il certificato.

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

Specifica l'identificatore univoco per il certificato.

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

-WebApp

Specifica un'app Web. Per ottenere un'app Web, usare il cmdlet Get-AzWebApp. Non è possibile usare il parametro WebApp nello stesso comando del parametro ResourceGroupName e/o webAppName.

Type:PSSite
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WebAppName

Specifica il nome dell'app Web per cui viene creata la nuova associazione SSL. Non è possibile usare il parametro WebAppName e il parametro WebApp nello stesso comando.

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

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

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

Input

PSSite

Output

HostNameSslState