Freigeben über


Remove-AzWebAppSSLBinding

Entfernt eine SSL-Bindung aus einem hochgeladenen Zertifikat.

Syntax

S1

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

S2

Remove-AzWebAppSSLBinding
    [-Name] <String>
    [[-DeleteCertificate] <Boolean>]
    [-WebApp] <PSSite>
    [-Force]
    [-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 namens 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

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DefaultProfile

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

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:

Nullable<T>[Boolean]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:4
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Force

Erzwingt die Ausführung des Befehls, ohne eine Benutzerbestätigung zu verlangen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:5
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

Gibt den Namen der Web App an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:3
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

S1
Position:0
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Slot

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

S1
Position:2
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WebApp

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

Parametereigenschaften

Typ:PSSite
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

S2
Position:0
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WebAppName

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

S1
Position:1
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

PSSite

Ausgaben

Void