Compartilhar via

Remove-AzWebAppSSLBinding

Módulo:
Az.Websites Module

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

Sintaxe

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

Description

O cmdlet Remove-AzWebAppSSLBinding remove uma associação SSL (Secure Sockets Layer) de um aplicativo Web 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

Remove-AzWebAppSSLBinding -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 ele não tiver mais nenhuma associação SSL.

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

Remove-AzWebAppSSLBinding -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 está incluído e o valor do parâmetro é definido como $False. Isso significa que o certificado não será excluído independentemente de ter alguma associação SSL ou não.

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

$WebApp = Get-AzWebApp -Name "ContosoWebApp"
Remove-AzWebAppSSLBinding -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 para um aplicativo Web. O primeiro comando usa o cmdlet Get-AzWebApp para criar uma referência de objeto ao 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-AzWebAppSSLBinding para remover a associação SSL.

Parâmetros

-Confirm

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DefaultProfile

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

Propriedades do parâmetro

Tipo:IAzureContextContainer
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DeleteCertificate

Especifica a ação a ser realizada se a associação SSL que está sendo removida for a única associação usada pelo certificado. Se DeleteCertificate estiver 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 .

Propriedades do parâmetro

Tipo:

Nullable<T>[Boolean]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:4
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Force

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:5
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Name

Especifica o nome do aplicativo Web.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:3
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ResourceGroupName

Especifica o nome do grupo de recursos ao qual o certificado é atribuído. Não é possível usar o parâmetro ResourceGroupName e o parâmetro WebApp no mesmo comando.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

S1
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Slot

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

S1
Cargo:2
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WebApp

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

Propriedades do parâmetro

Tipo:PSSite
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

S2
Cargo:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WebAppName

Especifica o nome do aplicativo Web. Não é possível usar o parâmetro WebAppName e o parâmetro WebApp no mesmo comando.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

S1
Cargo:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

PSSite

Saídas

Void