New-AzWebAppSSLBinding
Crée une liaison de certificat SSL pour une application web Azure.
Syntaxe
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
L’applet de commande New-AzWebAppSSLBinding crée une liaison de certificat SSL (Secure Socket Layer) pour une application web Azure. L’applet de commande crée une liaison SSL de deux façons :
- Vous pouvez lier une application web à un certificat existant.
- Vous pouvez charger un nouveau certificat, puis lier l’application web à ce nouveau certificat. Quelle que soit l’approche que vous utilisez, le certificat et l’application web doivent être associés au même groupe de ressources Azure. Si vous disposez d’une application web dans le groupe de ressources A et que vous souhaitez lier cette application web à un certificat dans le groupe de ressources B, la seule façon de le faire consiste à charger une copie du certificat dans le groupe de ressources A. Si vous chargez un nouveau certificat, gardez à l’esprit les exigences suivantes pour un certificat Azure SSL :
- Le certificat doit contenir une clé privée.
- Le certificat doit utiliser le format PFX (Personal Information Exchange).
- Le nom de l’objet du certificat doit correspondre au domaine utilisé pour accéder à l’application web.
- Le certificat doit utiliser au minimum un chiffrement à 2048 bits.
Exemples
Exemple 1 : Lier un certificat à une application web
New-AzWebAppSSLBinding -ResourceGroupName "ContosoResourceGroup" -WebAppName "ContosoWebApp" -Thumbprint "E3A38EBA60CAA1C162785A2E1C44A15AD450199C3" -Name "www.contoso.com"Cette commande lie un certificat Azure existant (un certificat avec l’empreinte numérique E3A38EBA60CAA1C162785A2E1C44A15AD450199C3) à l’application web nommée ContosoWebApp.
Exemple 2
Crée une liaison de certificat SSL pour une application web Azure. (généré automatiquement)
New-AzWebAppSSLBinding -Name 'www.contoso.com' -ResourceGroupName 'ContosoResourceGroup' -SslState Disabled -Thumbprint 'E3A38EBA60CAA1C162785A2E1C44A15AD450199C3' -WebAppName 'ContosoWebApp'powershell
Exemple 3
Crée une liaison de certificat SSL pour une application web Azure. (généré automatiquement)
New-AzWebAppSSLBinding -CertificateFilePath <String> -CertificatePassword <String> -Name 'www.contoso.com' -ResourceGroupName 'ContosoResourceGroup' -SslState Disabled -WebAppName 'ContosoWebApp'Paramètres
-CertificateFilePath
Spécifie le chemin d’accès au fichier pour le certificat à charger. Le paramètre CertificateFilePath est obligatoire uniquement si le certificat n’a pas encore été chargé sur Azure.
| Type: | String |
| Position: | 4 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-CertificatePassword
Spécifie le mot de passe de déchiffrement du certificat.
| Type: | String |
| Position: | 5 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Confirm
Vous demande une confirmation avant d’exécuter l’applet de commande.
| Type: | SwitchParameter |
| Alias: | cf |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
| Type: | IAzureContextContainer |
| Alias: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Name
Spécifie le nom de l’application web.
| Type: | String |
| Position: | 3 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ResourceGroupName
Spécifie le nom du groupe de ressources auquel le certificat est affecté. Vous ne pouvez pas utiliser le paramètre ResourceGroupName et le paramètre WebApp dans la même commande.
| Type: | String |
| Position: | 0 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Slot
Spécifie le nom de l’emplacement de déploiement d’application web. Vous pouvez utiliser l’applet de commande Get-AzWebAppSlot pour obtenir un emplacement. Les emplacements de déploiement vous permettent de mettre en scène et de valider des applications web sans que ces applications soient accessibles sur Internet. En règle générale, vous allez déployer vos modifications sur un site intermédiaire, valider ces modifications, puis déployer sur le site de production (accessible sur Internet).
| Type: | String |
| Position: | 2 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-SslState
Spécifie si le certificat est activé. Définissez le paramètre SSLState sur 1 pour activer le certificat ou définissez SSLState sur 0 pour désactiver le certificat.
| Type: | Nullable<T>[SslState] |
| Valeurs acceptées: | Disabled, SniEnabled, IpBasedEnabled |
| Position: | 4 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Thumbprint
Spécifie l’identificateur unique du certificat.
| Type: | String |
| Position: | 6 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-WebApp
Spécifie une application web. Pour obtenir une application web, utilisez l’applet de commande Get-AzWebApp. Vous ne pouvez pas utiliser le paramètre WebApp dans la même commande que le paramètre ResourceGroupName et/ou webAppName.
| Type: | PSSite |
| Position: | 0 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-WebAppName
Spécifie le nom de l’application web pour laquelle la nouvelle liaison SSL est créée. Vous ne pouvez pas utiliser le paramètre WebAppName et le paramètre WebApp dans la même commande.
| Type: | String |
| Position: | 1 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-WhatIf
Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.
| Type: | SwitchParameter |
| Alias: | wi |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
