New-AzWebAppSSLBinding

  • Référence
Module:
Az.Websites

Crée une liaison de certificat SSL pour une application web Azure.

Syntax

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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-CertificatePassword

Spécifie le mot de passe de déchiffrement du certificat.

Type:String
Position:5
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Spécifie le nom de l’application web.

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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]
Accepted values:Disabled, SniEnabled, IpBasedEnabled
Position:4
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Thumbprint

Spécifie l’identificateur unique du certificat.

Type:String
Position:6
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

PSSite

Sorties

HostNameSslState