Import-SPCertificate
Importa certificados en la granja de servidores de SharePoint.
Syntax
Import-SPCertificate
[-Path] <String>
[-Password <SecureString>]
[-Store <String>]
[-Exportable]
[-Replace]
[-AssignmentCollection <SPAssignmentCollection>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
Importa certificados desde el archivo especificado a la granja de servidores de SharePoint.
SharePoint admite certificados RSA y criptografía de curva elíptica (ECC). Puede importar certificados desde archivos PFX (PKCS #12), archivos P7B (PKCS #7) y archivos CER. Solo los archivos PFX contendrán claves privadas para los certificados, que son necesarios para que un certificado de servidor se asigne a un sitio web de IIS. Sin embargo, toda la cadena de certificados, desde el certificado de entidad final (hoja) hasta el certificado raíz, debe importarse a SharePoint para que las conexiones SSL se realicen correctamente.
Los certificados se implementan automáticamente en el almacén de certificados de Windows en cada servidor de la granja de servidores de SharePoint cuando se importan a SharePoint. Los certificados también se implementan automáticamente en los nuevos servidores de la granja de SharePoint cuando esos servidores se unen a la granja.
Al desconectar un servidor de una granja de SharePoint, no se quitarán automáticamente los certificados administrados por SharePoint del almacén de certificados de Windows de ese servidor. Al desinstalar SharePoint de un servidor, no se quitarán automáticamente los certificados administrados por SharePoint del almacén de certificados de Windows de ese servidor.
Ejemplos
------------EXAMPLE 1-----------
$password = ConvertTo-SecureString -AsPlainText -Force
Import-SPCertificate -Path "\\server\fileshare\certificates.pfx" -Password $password -ExportableEn este ejemplo se importan certificados y las claves privadas asociadas del archivo \\server\fileshare\certificates.pfx a la granja de servidores de SharePoint. También permite que las claves privadas que se importaron durante esta operación se exporten desde SharePoint en el futuro.
------------EXAMPLE 2-----------
Import-SPCertificate -Path D:\test.cerEn este ejemplo se importa un certificado del archivo D:\test.cer a la granja de servidores de SharePoint.
Parámetros
-AssignmentCollection
Administra objetos para su correcta eliminación. El uso de objetos como SPWeb o SPSite puede requerir una gran cantidad de memoria y su uso en scripts de Windows PowerShell requiere una administración adecuada de la memoria. Mediante el uso del objeto SPAssignment se pueden asignar objetos a una variable y eliminar los objetos cuando ya no sean necesarios para liberar memoria. Cuando se usan los objetos SPWeb, SPSite o SPSiteAdministration, los objetos se eliminan automáticamente si no se usa una colección de asignaciones o el parámetro Global.
Cuando se usa el parámetro Global, todos los objetos se guardan en el almacén global. Si los objetos no se usan de forma inmediata o se eliminan mediante el comando Stop-SPAssignment, puede producirse un error de memoria insuficiente.
| Type: | SPAssignmentCollection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Confirm
Solicitará 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 |
-Exportable
Especifica si se pueden exportar claves privadas de los certificados importados en SharePoint. Si no se especifica este parámetro, las claves privadas de certificados implementadas en el Almacén de certificados de Windows en cada servidor de la granja de servidores de SharePoint no se podrán exportar y SharePoint no le permitirá exportar las claves privadas desde la interfaz de administración de SharePoint.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Password
La contraseña si el archivo de certificado está protegido por una contraseña (para archivos PFX).
| Type: | SecureString |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
Ruta de acceso al archivo PFX, P7B o CER que contiene certificados.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Replace
Especifica que si los certificados que se importan renuevan los certificados existentes, las asignaciones de certificados de los certificados existentes se deben reemplazar inmediatamente por los certificados importados.
Si los certificados que se importan no renuevan los certificados existentes, no se realizará ningún cambio en la asignación de certificados.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Store
Almacén de certificados en el que se deben importar los certificados. A menos que sea necesario invalidar la detección automática de certificados de SharePoint, se recomienda omitir este parámetro para que SharePoint seleccione automáticamente el almacén de certificados adecuado para cada certificado.
| Type: | String |
| Accepted values: | EndEntity, Intermediate, Pending, Root |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Muestra lo que ocurriría si se ejecuta 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 |