New-AzureRmWebAppSSLBinding
Crea un enlace de certificado SSL para una aplicación web de Azure.
Advertencia
El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.
Aunque el módulo AzureRM puede seguir funcionando, ya no se mantiene ni se admite, colocando cualquier uso continuado a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.
Syntax
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
El cmdlet New-AzureRmWebAppSSLBinding 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
PS C:\>New-AzureRmWebAppSSLBinding -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.
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.
Tipo: | String |
Position: | 4 |
valor predeterminado: | None |
Requerido: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CertificatePassword
Especifica la contraseña de descifrado del certificado.
Tipo: | String |
Position: | 5 |
valor predeterminado: | None |
Requerido: | True |
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.
Tipo: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especifica el nombre de la aplicación web.
Tipo: | String |
Position: | 3 |
valor predeterminado: | None |
Requerido: | 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.
Tipo: | String |
Position: | 0 |
valor predeterminado: | None |
Requerido: | 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-AzureRMWebAppSlot 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).
Tipo: | String |
Position: | 2 |
valor predeterminado: | None |
Requerido: | 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.
Tipo: | Nullable<T>[SslState] |
valores aceptados: | Disabled, SniEnabled, IpBasedEnabled |
Position: | 4 |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Thumbprint
Especifica el identificador único del certificado.
Tipo: | String |
Position: | 6 |
valor predeterminado: | None |
Requerido: | 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-AzureRmWebApp. No puede usar el parámetro WebApp en el mismo comando que el parámetro ResourceGroupName o WebAppName.
Tipo: | PSSite |
Position: | 0 |
valor predeterminado: | None |
Requerido: | 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.
Tipo: | String |
Position: | 1 |
valor predeterminado: | None |
Requerido: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Parámetros: WebApp (ByValue)