Freigeben über

Remove-AzureRmWebAppSSLBinding

  • Referenz
Modul:
AzureRM.Websites

Entfernt eine SSL-Bindung aus einem hochgeladenen Zertifikat.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul möglicherweise weiterhin funktioniert, wird es nicht mehr gewartet, und es wird kein Support mehr angeboten. Die weitere Nutzung erfolgt daher nach Ermessen und Risiko des Benutzers. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

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>]

Beschreibung

Das Cmdlet Remove-AzureRmWebAppSSLBinding entfernt eine SSL-Bindung (Secure Sockets Layer) aus einer Azure Web App. SSL-Bindungen werden verwendet, um eine Web App einem Zertifikat zuzuordnen.

Beispiele

Beispiel 1: Entfernen einer SSL-Bindung für eine Web-App

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

Mit diesem Befehl wird die SSL-Bindung für die Web-App ContosoWebApp entfernt. Da der Parameter DeleteCertificate nicht enthalten ist, wird das Zertifikat gelöscht, wenn es keine SSL-Bindungen mehr hat.

Beispiel 2: Entfernen einer SSL-Bindung ohne Entfernen des Zertifikats

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

Ähnlich wie in Beispiel 1 entfernt dieser Befehl auch die SSL-Bindung für die Web App ContosoWebApp. In diesem Fall ist jedoch der Parameter DeleteCertificate enthalten, und der Parameterwert wird auf $False festgelegt. Das bedeutet, dass das Zertifikat unabhängig davon, ob es SSL-Bindungen enthält, nicht gelöscht wird.

Beispiel 3: Verwenden eines Objektverweises zum Entfernen einer SSL-Bindung

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

In diesem Beispiel wird ein Objektverweis auf die Web App-Website verwendet, um die SSL-Bindung für eine Web App zu entfernen. Der erste Befehl verwendet das Cmdlet Get-AzureRmWebApp, um einen Objektverweis auf die Web App namens ContosoWebApp zu erstellen. Dieser Objektverweis wird in einer Variablen namens $WebApp gespeichert. Der zweite Befehl verwendet den Objektverweis und das Cmdlet Remove-AzureRmWebAppSSLBinding , um die SSL-Bindung zu entfernen.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DeleteCertificate

Gibt die auszuführende Aktion an, wenn die zu entfernende SSL-Bindung die einzige Bindung ist, die vom Zertifikat verwendet wird. Wenn DeleteCertificate auf $False festgelegt ist, wird das Zertifikat beim Löschen der Bindung nicht gelöscht. Wenn DeleteCertificate auf $True festgelegt ist oder nicht im Befehl enthalten ist, wird das Zertifikat zusammen mit der SSL-Bindung gelöscht. Das Zertifikat wird nur gelöscht, wenn die ssl-Bindung, die entfernt wird, die einzige Bindung ist, die vom Zertifikat verwendet wird. Wenn das Zertifikat mehrere Bindungen enthält, wird das Zertifikat unabhängig vom Wert des DeleteCertificate-Parameters nicht entfernt.

Typ:Nullable<T>[Boolean]
Position:4
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Force

Erzwingt die Ausführung des Befehls ohne Aufforderung zur Bestätigung durch den Benutzer.

Typ:SwitchParameter
Position:5
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen der Web App an.

Typ:String
Position:3
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

Gibt den Namen der Ressourcengruppe an, der das Zertifikat zugewiesen ist. Sie können den Parameter ResourceGroupName und den WebApp-Parameter nicht im selben Befehl verwenden.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Slot

Gibt den Web App-Bereitstellungsplatz an. Verwenden Sie zum Abrufen eines Bereitstellungsplatzes das Cmdlet "Get-AzureRMWebAppSlot".

Typ:String
Position:2
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WebApp

Gibt eine Web-App an. Verwenden Sie zum Abrufen einer Web App das Cmdlet Get-AzureRmWebApp. Sie können den WebApp-Parameter nicht im selben Befehl wie der Parameter "ResourceGroupName " und/oder " WebAppName" verwenden.

Typ:PSSite
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WebAppName

Gibt den Namen der Web App an. Sie können den WebAppName-Parameter und den WebApp-Parameter nicht im selben Befehl verwenden.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt. Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Site

Parameter: WebApp (ByValue)

Ausgaben

Void