< Back
Remove-AzureRmWebAppSSLBinding
Post
NAME Remove-AzureRmWebAppSSLBinding
SYNOPSIS
Removes an SSL binding from an uploaded certificate.
SYNTAX
Remove-AzureRmWebAppSSLBinding [-ResourceGroupName] <String> [-WebAppName] <String> [[-Slot] <String>] [-Name] <String> [[-DeleteCertificate]
<Boolean>] [[-Force]] [-DefaultProfile <IAzureContextContainer>] [-Confirm] [-WhatIf] [<CommonParameters>]
Remove-AzureRmWebAppSSLBinding [-WebApp] <Site> [-Name] <String> [[-DeleteCertificate] <Boolean>] [[-Force]] [-DefaultProfile
<IAzureContextContainer>] [-Confirm] [-WhatIf] [<CommonParameters>]
DESCRIPTION
The Remove-AzureRmWebAppSSLBinding cmdlet removes a Secure Sockets Layer (SSL) binding from an Azure Web App. SSL bindings are used to associate a
Web App with a certificate.
PARAMETERS
-DefaultProfile <IAzureContextContainer>
The credentials, account, tenant, and subscription used for communication with azure.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-DeleteCertificate <Boolean>
Specifies the action to take place if the SSL binding being removed is the only binding used by the certificate. If DeleteCertificate is set
to $False, the certificate will not be deleted when the binding is deleted. If DeleteCertificate is set to $True or is not included in the
command, the certificate will be deleted along with the SSL binding.
The certificate will only be deleted if the SSL binding being removed is the only binding used by the certificate. If the certificate has more
than one binding, the certificate will not be removed regardless of the value of the DeleteCertificate parameter.
Required? false
Position? 4
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Force [<SwitchParameter>]
Forces the command to run without asking for user confirmation.
Required? false
Position? 5
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Name <String>
Specifies the name of the Web App.
Required? true
Position? 3
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-ResourceGroupName <String>
Specifies the name of the resource group that the certificate is assigned to.
You cannot use the ResourceGroupName parameter and the WebApp parameter in the same command.
Required? true
Position? 0
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Slot <String>
Specifies the Web App deployment slot. To get a deployment slot, use the Get-AzureRMWebAppSlot cmdlet.
Required? false
Position? 2
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-WebApp <Site>
Specifies a Web App. To get a Web App, use the Get-AzureRmWebApp cmdlet.
You cannot use the WebApp parameter in the same command as the ResourceGroupName parameter and/or the WebAppName .
Required? true
Position? 0
Default value None
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-WebAppName <String>
Specifies the name of the Web App.
You cannot use the WebAppName parameter and the WebApp parameter in the same command.
Required? true
Position? 1
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Prompts you for confirmation before running the cmdlet.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Shows what would happen if the cmdlet runs. The cmdlet is not run.Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
Site
Parameter 'WebApp' accepts value of type 'Site' from the pipeline
OUTPUTS
NOTES
Example 1: Remove an SSL binding for a web app
PS C:\\>Remove-AzureRmWebAppSSLBinding -ResourceGroupName "ContosoResourceGroup" -WebAppName "ContosoWebApp" -Name "www.contoso.com"
This command removes the SSL binding for the web app ContosoWebApp. Since the DeleteCertificate parameter is not included, the certificate will be
deleted if it no longer has any SSL bindings.
Example 2: Remove an SSL binding without removing the certificate
PS C:\\>Remove-AzureRmWebAppSSLBinding -ResourceGroupName "ContosoResourceGroup" -WebAppName "ContosoWebApp" -Name "www.contoso.com"
-DeleteCertificate $False
Similar to Example 1, this command also removes the SSL binding for the Web App ContosoWebApp. In this case, however, the DeleteCertificate
parameter is included, and the parameter value is set to $False. That means that the certificate will not be deleted regardless of whether it has
any SSL bindings or not.
Example 3: Use an object reference to remove an SSL binding
PS C:\\>$WebApp = Get-AzureRmWebApp -Name "ContosoWebApp"
PS C:\\> Remove-AzureRmWebAppSSLBinding -WebApp $WebApp -Name "www.contoso.com"
This example uses an object reference to the Web App website to remove the SSL binding for a Web App.
The first command uses the Get-AzureRmWebApp cmdlet to create an object reference to the Web App named ContosoWebApp. That object reference is
stored in a variable named $WebApp.
The second command uses the object reference and the Remove-AzureRmWebAppSSLBinding cmdlet to remove the SSL binding.
RELATED LINKS
Online Version: https://docs.microsoft.com/en-us/powers ... sslbinding
Get-AzureRmWebAppSSLBinding
New-AzureRmWebAppSSLBinding
Get-AzureRmWebAppSlot
Get-AzureRmWebApp
SYNOPSIS
Removes an SSL binding from an uploaded certificate.
SYNTAX
Remove-AzureRmWebAppSSLBinding [-ResourceGroupName] <String> [-WebAppName] <String> [[-Slot] <String>] [-Name] <String> [[-DeleteCertificate]
<Boolean>] [[-Force]] [-DefaultProfile <IAzureContextContainer>] [-Confirm] [-WhatIf] [<CommonParameters>]
Remove-AzureRmWebAppSSLBinding [-WebApp] <Site> [-Name] <String> [[-DeleteCertificate] <Boolean>] [[-Force]] [-DefaultProfile
<IAzureContextContainer>] [-Confirm] [-WhatIf] [<CommonParameters>]
DESCRIPTION
The Remove-AzureRmWebAppSSLBinding cmdlet removes a Secure Sockets Layer (SSL) binding from an Azure Web App. SSL bindings are used to associate a
Web App with a certificate.
PARAMETERS
-DefaultProfile <IAzureContextContainer>
The credentials, account, tenant, and subscription used for communication with azure.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-DeleteCertificate <Boolean>
Specifies the action to take place if the SSL binding being removed is the only binding used by the certificate. If DeleteCertificate is set
to $False, the certificate will not be deleted when the binding is deleted. If DeleteCertificate is set to $True or is not included in the
command, the certificate will be deleted along with the SSL binding.
The certificate will only be deleted if the SSL binding being removed is the only binding used by the certificate. If the certificate has more
than one binding, the certificate will not be removed regardless of the value of the DeleteCertificate parameter.
Required? false
Position? 4
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Force [<SwitchParameter>]
Forces the command to run without asking for user confirmation.
Required? false
Position? 5
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Name <String>
Specifies the name of the Web App.
Required? true
Position? 3
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-ResourceGroupName <String>
Specifies the name of the resource group that the certificate is assigned to.
You cannot use the ResourceGroupName parameter and the WebApp parameter in the same command.
Required? true
Position? 0
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Slot <String>
Specifies the Web App deployment slot. To get a deployment slot, use the Get-AzureRMWebAppSlot cmdlet.
Required? false
Position? 2
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-WebApp <Site>
Specifies a Web App. To get a Web App, use the Get-AzureRmWebApp cmdlet.
You cannot use the WebApp parameter in the same command as the ResourceGroupName parameter and/or the WebAppName .
Required? true
Position? 0
Default value None
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-WebAppName <String>
Specifies the name of the Web App.
You cannot use the WebAppName parameter and the WebApp parameter in the same command.
Required? true
Position? 1
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Prompts you for confirmation before running the cmdlet.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Shows what would happen if the cmdlet runs. The cmdlet is not run.Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
Site
Parameter 'WebApp' accepts value of type 'Site' from the pipeline
OUTPUTS
NOTES
Example 1: Remove an SSL binding for a web app
PS C:\\>Remove-AzureRmWebAppSSLBinding -ResourceGroupName "ContosoResourceGroup" -WebAppName "ContosoWebApp" -Name "www.contoso.com"
This command removes the SSL binding for the web app ContosoWebApp. Since the DeleteCertificate parameter is not included, the certificate will be
deleted if it no longer has any SSL bindings.
Example 2: Remove an SSL binding without removing the certificate
PS C:\\>Remove-AzureRmWebAppSSLBinding -ResourceGroupName "ContosoResourceGroup" -WebAppName "ContosoWebApp" -Name "www.contoso.com"
-DeleteCertificate $False
Similar to Example 1, this command also removes the SSL binding for the Web App ContosoWebApp. In this case, however, the DeleteCertificate
parameter is included, and the parameter value is set to $False. That means that the certificate will not be deleted regardless of whether it has
any SSL bindings or not.
Example 3: Use an object reference to remove an SSL binding
PS C:\\>$WebApp = Get-AzureRmWebApp -Name "ContosoWebApp"
PS C:\\> Remove-AzureRmWebAppSSLBinding -WebApp $WebApp -Name "www.contoso.com"
This example uses an object reference to the Web App website to remove the SSL binding for a Web App.
The first command uses the Get-AzureRmWebApp cmdlet to create an object reference to the Web App named ContosoWebApp. That object reference is
stored in a variable named $WebApp.
The second command uses the object reference and the Remove-AzureRmWebAppSSLBinding cmdlet to remove the SSL binding.
RELATED LINKS
Online Version: https://docs.microsoft.com/en-us/powers ... sslbinding
Get-AzureRmWebAppSSLBinding
New-AzureRmWebAppSSLBinding
Get-AzureRmWebAppSlot
Get-AzureRmWebApp