New-AzWebAppSSLBinding
Crea un enlace de certificado SSL para una aplicación web de Azure.
Sintaxis
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.
| Tipo: | String |
| Posición: | 4 |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-CertificatePassword
Especifica la contraseña de descifrado del certificado.
| Tipo: | String |
| Posición: | 5 |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-DefaultProfile
Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.
| Tipo: | IAzureContextContainer |
| Alias: | AzContext, AzureRmContext, AzureCredential |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Name
Especifica el nombre de la aplicación web.
| Tipo: | String |
| Posición: | 3 |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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 |
| Posición: | 0 |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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).
| Tipo: | String |
| Posición: | 2 |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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 |
| Posición: | 4 |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Thumbprint
Especifica el identificador único del certificado.
| Tipo: | String |
| Posición: | 6 |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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.
| Tipo: | PSSite |
| Posición: | 0 |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | 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 |
| Posición: | 1 |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
