Delen via

Remove-AzureRmWebAppSSLBinding

  • Referentie
Module:
AzureRM.Websites

Hiermee verwijdert u een SSL-binding uit een geüpload certificaat.

Waarschuwing

De AzureRM PowerShell-module is vanaf 29 februari 2024 officieel afgeschaft. Gebruikers wordt aangeraden om van AzureRM naar de Az PowerShell-module te migreren om ondersteuning en updates te garanderen.

Hoewel de AzureRM-module nog steeds kan functioneren, wordt deze niet meer onderhouden of ondersteund, waardoor het gebruik naar eigen goeddunken en risico van de gebruiker blijft bestaan. Raadpleeg onze migratiebronnen voor hulp bij de overgang naar de Az-module.

Syntaxis

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

De cmdlet Remove-AzureRmWebAppSSLBinding verwijdert een SSL-binding (Secure Sockets Layer) uit een Azure-web-app. SSL-bindingen worden gebruikt om een web-app te koppelen aan een certificaat.

Voorbeelden

Voorbeeld 1: Een SSL-binding voor een web-app verwijderen

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

Met deze opdracht verwijdert u de SSL-binding voor de web-app ContosoWebApp. Omdat de parameter DeleteCertificate niet is opgenomen, wordt het certificaat verwijderd als het geen SSL-bindingen meer heeft.

Voorbeeld 2: Een SSL-binding verwijderen zonder het certificaat te verwijderen

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

Net als in voorbeeld 1 verwijdert deze opdracht ook de SSL-binding voor de Web App ContosoWebApp. In dit geval wordt de parameter DeleteCertificate echter opgenomen en wordt de parameterwaarde ingesteld op $False. Dit betekent dat het certificaat niet wordt verwijderd, ongeacht of het SSL-bindingen bevat of niet.

Voorbeeld 3: Een objectverwijzing gebruiken om een SSL-binding te verwijderen

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

In dit voorbeeld wordt een objectverwijzing naar de web-app-website gebruikt om de SSL-binding voor een web-app te verwijderen. De eerste opdracht maakt gebruik van de Cmdlet Get-AzureRmWebApp om een objectverwijzing te maken naar de web-app met de naam ContosoWebApp. Deze objectverwijzing wordt opgeslagen in een variabele met de naam $WebApp. De tweede opdracht maakt gebruik van de objectverwijzing en de cmdlet Remove-AzureRmWebAppSSLBinding om de SSL-binding te verwijderen.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DeleteCertificate

Hiermee geeft u de actie op die moet worden uitgevoerd als de SSL-binding die wordt verwijderd, de enige binding is die door het certificaat wordt gebruikt. Als DeleteCertificate is ingesteld op $False, wordt het certificaat niet verwijderd wanneer de binding wordt verwijderd. Als DeleteCertificate is ingesteld op $True of niet is opgenomen in de opdracht, wordt het certificaat samen met de SSL-binding verwijderd. Het certificaat wordt alleen verwijderd als de SSL-binding die wordt verwijderd, de enige binding is die door het certificaat wordt gebruikt. Als het certificaat meer dan één binding heeft, wordt het certificaat niet verwijderd, ongeacht de waarde van de parameter DeleteCertificate .

Type:Nullable<T>[Boolean]
Position:4
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Force

Hiermee dwingt u de opdracht uit te voeren zonder dat u om bevestiging van de gebruiker wordt gevraagd.

Type:SwitchParameter
Position:5
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van de web-app.

Type:String
Position:3
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ResourceGroupName

Hiermee geeft u de naam op van de resourcegroep waaraan het certificaat is toegewezen. U kunt de parameter ResourceGroupName en de parameter WebApp niet gebruiken in dezelfde opdracht.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Slot

Hiermee geeft u de web-app-implementatiesite. Gebruik de cmdlet Get-AzureRMWebAppSlot om een implementatiesite op te halen.

Type:String
Position:2
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WebApp

Hiermee geeft u een web-app. Gebruik de cmdlet Get-AzureRmWebApp om een web-app op te halen. U kunt de parameter WebApp niet gebruiken in dezelfde opdracht als de parameter ResourceGroupName en/of de WebAppName.

Type:PSSite
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WebAppName

Hiermee geeft u de naam van de web-app. U kunt de parameter WebAppName en de parameter WebApp niet gebruiken in dezelfde opdracht.

Type:String
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd. Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

Site

Parameters: WebApp (ByValue)

Uitvoerwaarden

Void