Condividi tramite

Remove-AzureRmWebAppSSLBinding

  • Riferimento
Modulo:
AzureRM.Websites

Rimuove un'associazione SSL da un certificato caricato.

Avviso

Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.

Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.

Sintassi

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

Descrizione

Il cmdlet Remove-AzureRmWebAppSSLBinding rimuove un'associazione SSL (Secure Sockets Layer) da un'app Web di Azure. Le associazioni SSL vengono usate per associare un'app Web a un certificato.

Esempio

Esempio 1: Rimuovere un'associazione SSL per un'app Web

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

Questo comando rimuove l'associazione SSL per l'app Web ContosoWebApp. Poiché il parametro DeleteCertificate non è incluso, il certificato verrà eliminato se non contiene più associazioni SSL.

Esempio 2: Rimuovere un'associazione SSL senza rimuovere il certificato

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

Analogamente all'esempio 1, questo comando rimuove anche l'associazione SSL per l'app Web ContosoWebApp. In questo caso, tuttavia, viene incluso il parametro DeleteCertificate e il valore del parametro viene impostato su $False. Ciò significa che il certificato non verrà eliminato indipendentemente dal fatto che contenga o meno associazioni SSL.

Esempio 3: Usare un riferimento a un oggetto per rimuovere un'associazione SSL

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

In questo esempio viene usato un riferimento all'oggetto al sito Web dell'app Web per rimuovere l'associazione SSL per un'app Web. Il primo comando usa il cmdlet Get-AzureRmWebApp per creare un riferimento all'oggetto all'app Web denominata ContosoWebApp. Tale riferimento all'oggetto viene archiviato in una variabile denominata $WebApp. Il secondo comando usa il riferimento all'oggetto e il cmdlet Remove-AzureRmWebAppSSLBinding per rimuovere l'associazione SSL.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DeleteCertificate

Specifica l'azione da eseguire se l'associazione SSL da rimuovere è l'unica associazione utilizzata dal certificato. Se DeleteCertificate è impostato su $False, il certificato non verrà eliminato quando l'associazione viene eliminata. Se DeleteCertificate è impostato su $True o non è incluso nel comando, il certificato verrà eliminato insieme all'associazione SSL. Il certificato verrà eliminato solo se l'associazione SSL da rimuovere è l'unica associazione usata dal certificato. Se il certificato ha più associazioni, il certificato non verrà rimosso indipendentemente dal valore del parametro DeleteCertificate .

Tipo:Nullable<T>[Boolean]
Posizione:4
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

Forza l'esecuzione del comando senza chiedere conferma all'utente.

Tipo:SwitchParameter
Posizione:5
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specifica il nome dell'app Web.

Tipo:String
Posizione:3
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ResourceGroupName

Specifica il nome del gruppo di risorse a cui è assegnato il certificato. Non è possibile usare il parametro ResourceGroupName e il parametro WebApp nello stesso comando.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Slot

Specifica lo slot di distribuzione dell'app Web. Per ottenere uno slot di distribuzione, usare il cmdlet Get-AzureRMWebAppSlot.

Tipo:String
Posizione:2
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WebApp

Specifica un'app Web. Per ottenere un'app Web, usare il cmdlet Get-AzureRmWebApp. Non è possibile usare il parametro WebApp nello stesso comando del parametro ResourceGroupName e/o webAppName.

Tipo:PSSite
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WebAppName

Specifica il nome dell'app Web. Non è possibile usare il parametro WebAppName e il parametro WebApp nello stesso comando.

Tipo:String
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito. Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Site

Parametri: WebApp (ByValue)

Output

Void