Compartilhar via

New-AzWebAppSSLBinding

Módulo:
Az.Websites Module

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

Sintaxe

S1 

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

S2 

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

S3 

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

S4 

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 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 ser associados ao mesmo grupo de recursos 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 Azure:
  • O certificado deve conter uma chave privada.
  • O certificado deve usar o formato PFX (Exchange 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 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 Azure. (autogenerated)

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 Azure. (autogenerated)

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

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-CertificatePassword

Especifica a senha de descriptografia do certificado.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-Confirm

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
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

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

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

Propriedades do parâmetro

Tipo:

Nullable<T>[Microsoft.Azure.Management.WebSites.Models.SslState]

Valor padrão:None
Valores aceitos:Disabled, SniEnabled, IpBasedEnabled
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

-Thumbprint

Especifica o identificador exclusivo do certificado.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

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

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
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

Microsoft.Azure.Management.WebSites.Models.HostNameSslState