Compartir a través de

New-AzWebAppSSLBinding

Módulo:
Az.Websites Module

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

Sintaxis

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

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 asociarse con el mismo grupo de recursos 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 de Exchange de información personal (PFX).
  • El nombre del firmante del certificado debe coincidir con el dominio usado para acceder a la aplicación web.
  • El 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 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. (autogenerated)

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

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.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

S1
Posición:4
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
S3
Posición:4
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-CertificatePassword

Especifica la contraseña de descifrado del certificado.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

S1
Posición:5
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
S3
Posición:5
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DefaultProfile

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

Propiedades de parámetro

Tipo:IAzureContextContainer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

Especifica el nombre de la aplicación web.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:3
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

S1
Posición:0
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
S2
Posición:0
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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).

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

S1
Posición:2
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
S2
Posición:2
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:

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

Valor predeterminado:None
Valores aceptados:Disabled, SniEnabled, IpBasedEnabled
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:4
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Thumbprint

Especifica el identificador único del certificado.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

S2
Posición:6
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
S4
Posición:6
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:PSSite
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

S3
Posición:0
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
S4
Posición:0
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

S1
Posición:1
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
S2
Posición:1
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

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

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:wi

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

PSSite

Salidas

Microsoft.Azure.Management.WebSites.Models.HostNameSslState