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