Compartilhar via

Remove-AzureRmWebAppSSLBinding

  • Referência
Módulo:
AzureRM.Websites

Remove uma associação SSL de um certificado carregado.

Aviso

O módulo PowerShell do AzureRM foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo do Az PowerShell para garantir o suporte e as atualizações contínuas.

Embora o módulo AzureRM ainda possa funcionar, ele não tem suporte ou será mantido, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.

Sintaxe

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

Description

O cmdlet Remove-AzureRmWebAppSSLBinding remove uma associação SSL (Secure Sockets Layer) de um aplicativo Web do Azure. As associações SSL são usadas para associar um aplicativo Web a um certificado.

Exemplos

Exemplo 1: Remover uma associação SSL para um aplicativo Web

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

Esse comando remove a associação SSL para o aplicativo Web ContosoWebApp. Como o parâmetro DeleteCertificate não está incluído, o certificado será excluído se não tiver mais associações SSL.

Exemplo 2: Remover uma associação SSL sem remover o certificado

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

Semelhante ao Exemplo 1, esse comando também remove a associação SSL para o Aplicativo Web ContosoWebApp. Nesse caso, no entanto, o parâmetro DeleteCertificate é incluído e o valor do parâmetro é definido como $False. Isso significa que o certificado não será excluído, independentemente de ter ou não associações SSL.

Exemplo 3: Usar uma referência de objeto para remover uma associação SSL

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

Este exemplo usa uma referência de objeto ao site do aplicativo Web para remover a associação SSL de um aplicativo Web. O primeiro comando usa o cmdlet Get-AzureRmWebApp para criar uma referência de objeto para o aplicativo Web chamado ContosoWebApp. Essa referência de objeto é armazenada em uma variável chamada $WebApp. O segundo comando usa a referência de objeto e o cmdlet Remove-AzureRmWebAppSSLBinding para remover a associação SSL.

Parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DeleteCertificate

Especifica a ação a ser executada se a associação SSL que está sendo removida for a única associação usada pelo certificado. Se DeleteCertificate for definido como $False, o certificado não será excluído quando a associação for excluída. Se DeleteCertificate estiver definido como $True ou não estiver incluído no comando, o certificado será excluído junto com a associação SSL. O certificado só será excluído se a associação SSL que está sendo removida for a única associação usada pelo certificado. Se o certificado tiver mais de uma associação, o certificado não será removido, independentemente do valor do parâmetro DeleteCertificate .

Tipo:Nullable<T>[Boolean]
Cargo:4
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Force

Força o comando a ser executado sem solicitar a confirmação do usuário.

Tipo:SwitchParameter
Cargo:5
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifica o nome do aplicativo Web.

Tipo:String
Cargo:3
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ResourceGroupName

Especifica o nome do grupo de recursos ao qual o certificado está atribuído. Você não pode usar o parâmetro ResourceGroupName e o parâmetro WebApp no mesmo comando.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Slot

Especifica o slot de implantação do Aplicativo Web. Para obter um slot de implantação, use o cmdlet Get-AzureRMWebAppSlot.

Tipo:String
Cargo:2
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WebApp

Especifica um aplicativo Web. Para obter um aplicativo Web, use o cmdlet Get-AzureRmWebApp. Você não pode usar o parâmetro WebApp no mesmo comando que o parâmetro ResourceGroupName e/ou o WebAppName.

Tipo:PSSite
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WebAppName

Especifica o nome do aplicativo Web. Você não pode usar o parâmetro WebAppName e o parâmetro WebApp no mesmo comando.

Tipo:String
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado. Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Site

Parâmetros: WebApp (ByValue)

Saídas

Void