New-AzWebAppSSLBinding

  • Referencia
Módulo:
Az.Websites

Crea un enlace de certificado SSL para una aplicación web de Azure.

Syntax

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

El cmdlet New-AzWebAppSSLBinding crea un enlace de certificado de Capa de sockets seguros (SSL) para una aplicación web de Azure. El cmdlet crea un enlace SSL de dos maneras:

  • Puede enlazar una aplicación web a un certificado existente.
  • Puede cargar un nuevo certificado y, a continuación, enlazar la aplicación web a este nuevo certificado. Independientemente del enfoque que use, el certificado y la aplicación web deben estar asociados al mismo grupo de recursos de Azure. Si tiene una aplicación web en el grupo de recursos A y desea enlazar esa aplicación web a un certificado del grupo de recursos B, la única manera de hacerlo es cargar una copia del certificado en el grupo de recursos A. Si carga un nuevo certificado, tenga en cuenta los siguientes requisitos para un certificado SSL de Azure:
  • El certificado debe contener una clave privada.
  • El certificado debe usar el formato intercambio de información personal (PFX).
  • El nombre del firmante del certificado debe coincidir con el dominio usado para acceder a la aplicación web.
  • Este certificado debe usar un cifrado de 2048 bits como mínimo.

Ejemplos

Ejemplo 1: Enlazar un certificado a una aplicación web

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

Este comando enlaza un certificado de Azure existente (un certificado con la huella digital E3A38EBA60CAA1C162785A2E1C44A15AD450199C3) a la aplicación web denominada ContosoWebApp.

Ejemplo 2

Crea un enlace de certificado SSL para una aplicación web de Azure. (generado automáticamente)

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

powershell

Ejemplo 3

Crea un enlace de certificado SSL para una aplicación web de Azure. (generado automáticamente)

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

Parámetros

-CertificateFilePath

Especifica la ruta de acceso del archivo para que se cargue el certificado. El parámetro CertificateFilePath solo es necesario si el certificado aún no se ha cargado en Azure.

Type:String
Position:4
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-CertificatePassword

Especifica la contraseña de descifrado del certificado.

Type:String
Position:5
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifica el nombre de la aplicación web.

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

Especifica el nombre del grupo de recursos al que se asigna el certificado. No puede usar el parámetro ResourceGroupName y el parámetro WebApp en el mismo comando.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Slot

Especifica el nombre de la ranura de implementación de aplicación web. Puede usar el cmdlet Get-AzWebAppSlot para obtener una ranura. Las ranuras de implementación proporcionan una manera de almacenar provisionalmente y validar las aplicaciones web sin que esas aplicaciones sean accesibles a través de Internet. Normalmente, implementará los cambios en un sitio de ensayo, validará esos cambios y, a continuación, se implementará en el sitio de producción (accesible desde Internet).

Type:String
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SslState

Especifica si el certificado está habilitado. Establezca el parámetro SSLState en 1 para habilitar el certificado o establezca SSLState en 0 para deshabilitar el certificado.

Type:Nullable<T>[SslState]
Accepted values:Disabled, SniEnabled, IpBasedEnabled
Position:4
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Thumbprint

Especifica el identificador único del certificado.

Type:String
Position:6
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WebApp

Especifica una aplicación web. Para obtener una aplicación web, use el cmdlet Get-AzWebApp. No puede usar el parámetro WebApp en el mismo comando que el parámetro ResourceGroupName o WebAppName.

Type:PSSite
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WebAppName

Especifica el nombre de la aplicación web para la que se va a crear el nuevo enlace SSL. No puede usar el parámetro WebAppName y el parámetro WebApp en el mismo comando.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

PSSite

Salidas

HostNameSslState