Partilhar via


New-AzWebAppSSLBinding

Cria uma associação de certificado SSL para um Aplicativo Web do Azure.

Sintaxe

New-AzWebAppSSLBinding
   [-ResourceGroupName] <String>
   [-WebAppName] <String>
   [[-Slot] <String>]
   [-Name] <String>
   [[-SslState] <SslState>]
   [-CertificateFilePath] <String>
   [-CertificatePassword] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzWebAppSSLBinding
   [-ResourceGroupName] <String>
   [-WebAppName] <String>
   [[-Slot] <String>]
   [-Name] <String>
   [[-SslState] <SslState>]
   [-Thumbprint] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzWebAppSSLBinding
   [-WebApp] <PSSite>
   [-Name] <String>
   [[-SslState] <SslState>]
   [-CertificateFilePath] <String>
   [-CertificatePassword] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzWebAppSSLBinding
   [-WebApp] <PSSite>
   [-Name] <String>
   [[-SslState] <SslState>]
   [-Thumbprint] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet New-AzWebAppSSLBinding cria uma associação de certificado SSL (Secure Socket Layer) para um Aplicativo Web do Azure. O cmdlet cria uma associação SSL de duas maneiras:

  • Você pode vincular um aplicativo Web a um certificado existente.
  • Você pode carregar um novo certificado e, em seguida, vincular o Web App a esse novo certificado. Independentemente da abordagem usada, o certificado e o Aplicativo Web devem estar associados ao mesmo grupo de recursos do Azure. Se você tiver um Aplicativo Web no Grupo de Recursos A e quiser vincular esse Aplicativo Web a um certificado no Grupo de Recursos B, a única maneira de fazer isso é carregar uma cópia do certificado para o Grupo de Recursos A. Se você carregar um novo certificado, lembre-se dos seguintes requisitos para um certificado SSL do Azure:
  • O certificado deve conter uma chave privada.
  • O certificado deve usar o formato de Troca de Informações Pessoais (PFX).
  • O nome do assunto do certificado deve corresponder ao domínio usado para acessar o Web App.
  • O certificado deve usar um mínimo de criptografia de 2048 bits.

Exemplos

Exemplo 1: Vincular um certificado a um aplicativo Web

New-AzWebAppSSLBinding -ResourceGroupName "ContosoResourceGroup" -WebAppName "ContosoWebApp" -Thumbprint "E3A38EBA60CAA1C162785A2E1C44A15AD450199C3" -Name "www.contoso.com"

Este comando vincula um certificado existente do Azure (um certificado com o E3A38EBA60CAA1C162785A2E1C44A15AD450199C3 de impressão digital) ao aplicativo Web chamado ContosoWebApp.

Exemplo 2

Cria uma associação de certificado SSL para um Aplicativo Web do Azure. (gerado automaticamente)

New-AzWebAppSSLBinding -Name 'www.contoso.com' -ResourceGroupName 'ContosoResourceGroup' -SslState Disabled -Thumbprint 'E3A38EBA60CAA1C162785A2E1C44A15AD450199C3' -WebAppName 'ContosoWebApp'

powershell

Exemplo 3

Cria uma associação de certificado SSL para um Aplicativo Web do Azure. (gerado automaticamente)

New-AzWebAppSSLBinding -CertificateFilePath <String> -CertificatePassword <String> -Name 'www.contoso.com' -ResourceGroupName 'ContosoResourceGroup' -SslState Disabled -WebAppName 'ContosoWebApp'

Parâmetros

-CertificateFilePath

Especifica o caminho do arquivo para o certificado a ser carregado. O parâmetro CertificateFilePath só é necessário se o certificado ainda não tiver sido carregado no Azure.

Tipo:String
Position:4
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-CertificatePassword

Especifica a senha de descriptografia para o certificado.

Tipo:String
Position:5
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Name

Especifica o nome do aplicativo Web.

Tipo:String
Position:3
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais: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.

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Slot

Especifica o nome do slot de implantação do Aplicativo Web. Você pode usar o cmdlet Get-AzWebAppSlot para obter um slot. Os slots de implantação fornecem uma maneira de preparar e validar aplicativos Web sem que esses aplicativos estejam acessíveis pela Internet. Normalmente, você implantará suas alterações em um site de preparação, validará essas alterações e, em seguida, implantará no site de produção (acessível pela Internet).

Tipo:String
Position:2
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SslState

Especifica se o certificado está habilitado. Defina o parâmetro SSLState como 1 para habilitar o certificado ou defina SSLState como 0 para desabilitar o certificado.

Tipo:Nullable<T>[SslState]
Valores aceites:Disabled, SniEnabled, IpBasedEnabled
Position:4
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Thumbprint

Especifica o identificador exclusivo do certificado.

Tipo:String
Position:6
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WebApp

Especifica um aplicativo Web. Para obter um aplicativo Web, use o cmdlet Get-AzWebApp. Não é possível usar o parâmetro WebApp no mesmo comando que o parâmetro ResourceGroupName e/ou o WebAppName.

Tipo:PSSite
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-WebAppName

Especifica o nome do Aplicativo Web para o qual a nova associação SSL está sendo criada. Não é possível usar o parâmetro WebAppName e o parâmetro WebApp no mesmo comando.

Tipo:String
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

PSSite

Saídas

HostNameSslState