Partager via

Remove-AzureRmWebAppSSLBinding

  • Référence
Module:
AzureRM.Websites

Supprime une liaison SSL d’un certificat chargé.

Avertissement

Le module AzureRM PowerShell a été officiellement déprécié le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.

Il est possible que le module AzureRM fonctionne encore, mais il ne fait plus l’objet de maintenance ni de support. L’utilisateur peut continuer à s’en servir s’il le souhaite, à ses propres risques. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.

Syntaxe

Remove-AzureRmWebAppSSLBinding
      [-Name] <String>
      [[-DeleteCertificate] <Boolean>]
      [-Force]
      [-ResourceGroupName] <String>
      [-WebAppName] <String>
      [[-Slot] <String>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureRmWebAppSSLBinding
      [-Name] <String>
      [[-DeleteCertificate] <Boolean>]
      [-Force]
      [-WebApp] <PSSite>
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

L’applet de commande Remove-AzureRmWebAppSSLBinding supprime une liaison SSL (Secure Sockets Layer) d’une application web Azure. Les liaisons SSL sont utilisées pour associer une application web à un certificat.

Exemples

Exemple 1 : Supprimer une liaison SSL pour une application web

PS C:\>Remove-AzureRmWebAppSSLBinding -ResourceGroupName "ContosoResourceGroup" -WebAppName "ContosoWebApp" -Name "www.contoso.com"

Cette commande supprime la liaison SSL pour l’application web ContosoWebApp. Étant donné que le paramètre DeleteCertificate n’est pas inclus, le certificat est supprimé s’il n’a plus de liaisons SSL.

Exemple 2 : Supprimer une liaison SSL sans supprimer le certificat

PS C:\>Remove-AzureRmWebAppSSLBinding -ResourceGroupName "ContosoResourceGroup" -WebAppName "ContosoWebApp" -Name "www.contoso.com" -DeleteCertificate $False

Comme dans l’exemple 1, cette commande supprime également la liaison SSL pour l’application web ContosoWebApp. Dans ce cas, toutefois, le paramètre DeleteCertificate est inclus et la valeur du paramètre est définie sur $False. Cela signifie que le certificat ne sera pas supprimé, qu’il ait ou non des liaisons SSL.

Exemple 3 : Utiliser une référence d’objet pour supprimer une liaison SSL

PS C:\>$WebApp = Get-AzureRmWebApp -Name "ContosoWebApp"
PS C:\> Remove-AzureRmWebAppSSLBinding -WebApp $WebApp -Name "www.contoso.com"

Cet exemple utilise une référence d’objet au site web d’application web pour supprimer la liaison SSL d’une application web. La première commande utilise l’applet de commande Get-AzureRmWebApp pour créer une référence d’objet à l’application web nommée ContosoWebApp. Cette référence d’objet est stockée dans une variable nommée $WebApp. La deuxième commande utilise la référence d’objet et l’applet de commande Remove-AzureRmWebAppSSLBinding pour supprimer la liaison SSL.

Paramètres

-Confirm

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

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
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: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

-DeleteCertificate

Spécifie l’action à effectuer si la liaison SSL en cours de suppression est la seule liaison utilisée par le certificat. Si DeleteCertificate est défini sur $False, le certificat ne sera pas supprimé lorsque la liaison est supprimée. Si DeleteCertificate est défini sur $True ou n’est pas inclus dans la commande, le certificat est supprimé avec la liaison SSL. Le certificat est supprimé uniquement si la liaison SSL en cours de suppression est la seule liaison utilisée par le certificat. Si le certificat a plusieurs liaisons, le certificat ne sera pas supprimé, quelle que soit la valeur du paramètre DeleteCertificate .

Type:Nullable<T>[Boolean]
Position:4
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Force

Force l’exécution de la commande sans demander la confirmation de l’utilisateur.

Type:SwitchParameter
Position:5
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 l’emplacement de déploiement d’application web. Pour obtenir un emplacement de déploiement, utilisez l’applet de commande Get-AzureRMWebAppSlot.

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

-WebApp

Spécifie une application web. Pour obtenir une application web, utilisez l’applet de commande Get-AzureRmWebApp. 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. 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. 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:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

Site

Paramètres : WebApp (ByValue)

Sorties

Void