Compartilhar via

New-AzureRmWebAppSSLBinding

  • Referência
Módulo:
AzureRM.Websites

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

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

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

Description

O cmdlet New-AzureRmWebAppSSLBinding 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, em seguida, associar o Aplicativo Web 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 associar esse Aplicativo Web a um certificado no Grupo de Recursos B, a única maneira de fazer isso é carregar uma cópia do certificado no 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 PFX (Personal Information Exchange).
  • O nome da entidade do certificado deve corresponder ao domínio usado para acessar o aplicativo Web.
  • O certificado deve usar, no mínimo, uma criptografia de 2048 bits.

Exemplos

Exemplo 1: Associar um certificado a um aplicativo Web

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

Esse comando associa um certificado existente do Azure (um certificado com o E3A38EBA60CAA1C162785A2E1C44A15AD450199C3 de impressão digital) ao aplicativo Web chamado 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 para o certificado.

Tipo:String
Cargo:5
Valor padrão:None
Obrigatório:True
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

-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 nome do slot de implantação do Aplicativo Web. Você pode usar o cmdlet Get-AzureRMWebAppSlot para obter um slot. Os slots de implantação fornecem uma maneira de preparar e validar aplicativos Web sem que esses aplicativos sejam acessíveis pela Internet. Normalmente, você implantará suas alterações em um site de preparo, validará essas alterações e, em seguida, 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-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 para o qual a nova associação SSL está sendo criada. 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

Entradas

Site

Parâmetros: WebApp (ByValue)

Saídas

HostNameSslState