Freigeben über

Remove-AzWebAppSSLBinding

  • Referenz
Modul:
Az.Websites

Entfernt eine SSL-Bindung aus einem hochgeladenen Zertifikat.

Syntax

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

Beschreibung

Das cmdlet Remove-AzWebAppSSLBinding 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

Remove-AzWebAppSSLBinding -ResourceGroupName "ContosoResourceGroup" -WebAppName "ContosoWebApp" -Name "www.contoso.com"

Mit diesem Befehl wird die SSL-Bindung für die Web-App ContosoWebApp entfernt. Da der DeleteCertificate Parameter 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

Remove-AzWebAppSSLBinding -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 DeleteCertificate Parameter 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

$WebApp = Get-AzWebApp -Name "ContosoWebApp"
Remove-AzWebAppSSLBinding -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-AzWebApp, 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 den Remove-AzWebAppSSLBinding Cmdlet, um die SSL-Bindung zu entfernen.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

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:AzContext, 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 mehr als eine Bindung aufweist, 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 eine Benutzerbestätigung zu verlangen.

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-AzWebAppSlot.

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-AzWebApp. Sie können den parameter WebApp nicht im gleichen Befehl wie der parameter ResourceGroupName und/oder den WebAppNameverwenden.

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 parameter WebAppName 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 passiert, 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

PSSite

Ausgaben

Void