Compartilhar via

New-AzWebAppSSLBinding

  • Referência
Módulo:
Az.Websites

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 associar um aplicativo Web a um certificado existente.
  • Você pode carregar um novo certificado e associar o Aplicativo Web a esse novo certificado. Independentemente de qual abordagem você usa, 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 associar 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, tenha em mente os seguintes requisitos para um certificado SSL do Azure:
  • O certificado deve conter uma chave privada.
  • O certificado deve usar o formato PFX (Troca de Informações Pessoais).
  • O nome da entidade do certificado deve corresponder ao domínio usado para acessar o Aplicativo Web.
  • O certificado deve usar um mínimo de criptografia de 2048 bits.

Exemplos

Exemplo 1: associar um certificado a um aplicativo Web

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

Esse comando associa um certificado do Azure existente (um certificado com a impressão digital E3A38EBA60CAA1C162785A2E1C44A15AD450199C3) 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ó será necessário se o certificado ainda não tiver sido carregado no Azure.

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

-CertificatePassword

Especifica a senha de descriptografia do certificado.

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

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
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:AzContext, AzureRmContext, AzureCredential
Cargo:Named
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 é 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 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 fiquem acessíveis pela Internet. Normalmente, você implantará suas alterações em um site de preparo, validará essas alterações e implantará no site de produção (acessível pela Internet).

Tipo:String
Cargo:2
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 aceitos:Disabled, SniEnabled, IpBasedEnabled
Cargo:4
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Thumbprint

Especifica o identificador exclusivo do certificado.

Tipo:String
Cargo:6
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 oWebAppName .

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

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

Entradas

PSSite

Saídas

HostNameSslState