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

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

$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 mit dem Namen ContosoWebApp zu erstellen. Dieser Objektverweis wird in einer Variablen namens $WebApp gespeichert. Der zweite Befehl verwendet den Objektverweis und das Cmdlet Remove-AzWebAppSSLBinding , um die SSL-Bindung zu entfernen.

Parameter

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Nullable<T>[Boolean]
Position:4
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:5
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Gibt den Namen der Web App an.

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Slot

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

Type:String
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WebApp

Gibt eine Web-App an. Verwenden Sie das Cmdlet "Get-AzWebApp", um eine Web App abzurufen. Sie können den WebApp-Parameter nicht im selben Befehl wie der Parameter "ResourceGroupName " und/oder " WebAppName" verwenden.

Type:PSSite
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WebAppName

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

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

PSSite

Ausgaben

Void