Condividi tramite

New-AzureRmWebAppSSLBinding

  • Riferimento
Modulo:
AzureRM.Websites

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

Avviso

Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.

Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.

Sintassi

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

Descrizione

Il cmdlet New-AzureRmWebAppSSLBinding 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

PS C:\>New-AzureRmWebAppSSLBinding -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.

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

-DefaultProfile

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

Tipo:IAzureContextContainer
Alias: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-AzureRMWebAppSlot 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-AzureRmWebApp. 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

Input

Site

Parametri: WebApp (ByValue)

Output

HostNameSslState