Partager via

New-AzWebAppSSLBinding

  • Référence
Module:
Az.Websites

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

La cmdlet 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 un minimum de 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 n’est nécessaire que 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 invite à confirmer 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 le 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

Affiche ce qui se passerait si l’applet de commande s’exécute. 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

Entrées

PSSite

Sorties

HostNameSslState