Condividi tramite

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.

Tipo:String
Posizione:4
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CertificatePassword

Specifica la password di decrittografia per il certificato.

Tipo:String
Posizione:5
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specifica il nome dell'app Web.

Tipo:String
Posizione:3
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly: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).

Tipo:String
Posizione:2
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:Nullable<T>[SslState]
Valori accettati:Disabled, SniEnabled, IpBasedEnabled
Posizione:4
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Thumbprint

Specifica l'identificatore univoco per il certificato.

Tipo:String
Posizione:6
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:PSSite
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly: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.

Tipo:String
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

PSSite

Output

HostNameSslState