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.

Syntax

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
Aliases:cf
Position:Named
standaardwaarde:False
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters: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
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:5
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Hiermee geeft u de naam van de web-app.

Type:String
Position:3
standaardwaarde:None
Vereist:True
Accept pipeline input:False
Accept wildcard characters: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
standaardwaarde:None
Vereist:True
Accept pipeline input:False
Accept wildcard characters:False

-Slot

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

Type:String
Position:2
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters: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
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters: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
standaardwaarde:None
Vereist:True
Accept pipeline input:False
Accept wildcard characters: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
Aliases:wi
Position:Named
standaardwaarde:False
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

Site

Parameters: WebApp (ByValue)

Uitvoerwaarden

Void