Partager via

New-AzWebAppSSLBinding

Module:
Az.Websites Module

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

Syntaxe

S1 

New-AzWebAppSSLBinding
    [-ResourceGroupName] <String>
    [-WebAppName] <String>
    [[-Slot] <String>]
    [-Name] <String>
    [[-SslState] <SslState>]
    [-CertificateFilePath] <String>
    [-CertificatePassword] <String>
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

S2 

New-AzWebAppSSLBinding
    [-ResourceGroupName] <String>
    [-WebAppName] <String>
    [[-Slot] <String>]
    [-Name] <String>
    [[-SslState] <SslState>]
    [-Thumbprint] <String>
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

S3 

New-AzWebAppSSLBinding
    [-WebApp] <PSSite>
    [-Name] <String>
    [[-SslState] <SslState>]
    [-CertificateFilePath] <String>
    [-CertificatePassword] <String>
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

S4 

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 SSL Azure :
  • Le certificat doit contenir une clé privée.
  • Le certificat doit utiliser le format d’informations personnelles Exchange (PFX).
  • 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. (autogenerated)

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. (autogenerated)

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é dans Azure.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

S1
Position:4
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
S3
Position:4
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-CertificatePassword

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

S1
Position:5
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
S3
Position:5
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DefaultProfile

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

Propriétés du paramètre

Type:IAzureContextContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Name

Spécifie le nom de l’application web.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:3
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

S1
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
S2
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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).

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

S1
Position:2
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
S2
Position:2
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:

Nullable<T>[Microsoft.Azure.Management.WebSites.Models.SslState]

Valeur par défaut:None
Valeurs acceptées:Disabled, SniEnabled, IpBasedEnabled
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:4
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Thumbprint

Spécifie l’identificateur unique du certificat.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

S2
Position:6
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
S4
Position:6
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:PSSite
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

S3
Position:0
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
S4
Position:0
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

S1
Position:1
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
S2
Position:1
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

PSSite

Sorties

Microsoft.Azure.Management.WebSites.Models.HostNameSslState