Udostępnij za pośrednictwem

Remove-AzureRmWebAppSSLBinding

  • Odwołanie
Moduł:
AzureRM.Websites

Usuwa powiązanie SSL z przekazanego certyfikatu.

Ostrzeżenie

Moduł AzureRM PowerShell jest oficjalnie przestarzały od 29 lutego 2024 r. Zaleca się migrowanie użytkowników z modułu AzureRM do modułu Az programu PowerShell w celu zapewnienia ciągłej obsługi i aktualizacji.

Mimo że moduł AzureRM może nadal działać, nie jest już utrzymywany ani obsługiwany, umieszczając wszelkie dalsze zastosowania według uznania i ryzyka użytkownika. Zapoznaj się z naszymi zasobami migracji, aby uzyskać wskazówki dotyczące przejścia do modułu Az.

Składnia

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

Opis

Polecenie cmdlet Remove-AzureRmWebAppSSLBinding usuwa powiązanie secure Sockets Layer (SSL) z aplikacji internetowej platformy Azure. Powiązania SSL służą do kojarzenia aplikacji internetowej z certyfikatem.

Przykłady

Przykład 1. Usuwanie powiązania SSL dla aplikacji internetowej

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

To polecenie usuwa powiązanie SSL dla aplikacji internetowej ContosoWebApp. Ponieważ parametr DeleteCertificate nie jest dołączony, certyfikat zostanie usunięty, jeśli nie ma już żadnych powiązań SSL.

Przykład 2. Usuwanie powiązania SSL bez usuwania certyfikatu

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

Podobnie jak w przykładzie 1, to polecenie usuwa również powiązanie SSL dla aplikacji internetowej ContosoWebApp. W tym przypadku jednak parametr DeleteCertificate jest uwzględniony, a wartość parametru jest ustawiona na $False. Oznacza to, że certyfikat nie zostanie usunięty niezależnie od tego, czy ma jakiekolwiek powiązania SSL, czy nie.

Przykład 3. Używanie odwołania do obiektu w celu usunięcia powiązania SSL

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

W tym przykładzie użyto odwołania do obiektu do witryny internetowej aplikacji internetowej, aby usunąć powiązanie SSL dla aplikacji internetowej. Pierwsze polecenie używa polecenia cmdlet Get-AzureRmWebApp do utworzenia odwołania do obiektu do aplikacji internetowej o nazwie ContosoWebApp. Odwołanie do tego obiektu jest przechowywane w zmiennej o nazwie $WebApp. Drugie polecenie używa odwołania do obiektu i polecenia cmdlet Remove-AzureRmWebAppSSLBinding w celu usunięcia powiązania SSL.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DeleteCertificate

Określa akcję do wykonania, jeśli usuwane powiązanie SSL jest jedynym powiązaniem używanym przez certyfikat. Jeśli właściwość DeleteCertificate jest ustawiona na $False, certyfikat nie zostanie usunięty po usunięciu powiązania. Jeśli właściwość DeleteCertificate jest ustawiona na $True lub nie jest uwzględniona w poleceniu, certyfikat zostanie usunięty wraz z powiązaniem SSL. Certyfikat zostanie usunięty tylko wtedy, gdy usuwane powiązanie SSL jest jedynym powiązaniem używanym przez certyfikat. Jeśli certyfikat ma więcej niż jedno powiązanie, certyfikat nie zostanie usunięty niezależnie od wartości parametru DeleteCertificate .

Typ:Nullable<T>[Boolean]
Position:4
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Force

Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.

Typ:SwitchParameter
Position:5
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwę aplikacji internetowej.

Typ:String
Position:3
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ResourceGroupName

Określa nazwę grupy zasobów, do której jest przypisany certyfikat. Nie można użyć parametru ResourceGroupName i parametru WebApp w tym samym poleceniu.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Slot

Określa miejsce wdrożenia aplikacji internetowej. Aby uzyskać miejsce wdrożenia, użyj polecenia cmdlet Get-AzureRMWebAppSlot.

Typ:String
Position:2
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WebApp

Określa aplikację internetową. Aby uzyskać aplikację internetową, użyj polecenia cmdlet Get-AzureRmWebApp. Nie można użyć parametru WebApp w tym samym poleceniu co parametr ResourceGroupName i/lub WebAppName.

Typ:PSSite
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-WebAppName

Określa nazwę aplikacji internetowej. Nie można użyć parametru WebAppName i parametru WebApp w tym samym poleceniu.

Typ:String
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane. Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie zostało uruchomione.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

Site

Parametry: WebApp (ByValue)

Dane wyjściowe

Void