Export-SPCertificate

  • Referencia
Módulo:
sharepoint-server

Exporta certificados de la granja de servidores de SharePoint.

Syntax

Export-SPCertificate
      [-Identity] <SPServerCertificatePipeBind>
      -Password <SecureString>
      [-EncryptionType <String>]
      [-IncludeAllCertificatesInCertificationPath]
      [-NoExtendedProperties]
      [-Path <String>]
      [-Force]
      [-AssignmentCollection <SPAssignmentCollection>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Export-SPCertificate
      [-Identity] <SPServerCertificatePipeBind>
      -Type <String>
      [-IncludeAllCertificatesInCertificationPath]
      [-Path <String>]
      [-Force]
      [-AssignmentCollection <SPAssignmentCollection>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Exporta certificados de la granja de servidores de SharePoint a un archivo de certificado. Este archivo de certificado exportado se almacena de forma predeterminada en el sitio de Administración central, pero también se puede almacenar en una ruta de acceso especificada por el parámetro Path.

SharePoint admite la exportación de certificados a archivos PFX (PKCS #12), archivos P7B (PKCS #7) y archivos CER. Tanto los archivos PFX como los archivos P7B pueden contener varios certificados, lo que resulta útil para exportar una cadena de certificados desde el certificado de entidad final (hoja) al certificado raíz. Sin embargo, solo los archivos PFX pueden contener claves privadas para los certificados, que son necesarias para que un certificado de servidor se asigne a un sitio web de IIS. Los archivos CER solo contienen un único certificado.

Ejemplos

------------EXAMPLE 1-----------

$password = ConvertTo-SecureString -AsPlainText -Force 
 
Export-SPCertificate -Identity "Team Sites Certificate" -Password $password -IncludeAllCertificatesInCertificationPath -Path "\\server\fileshare\certificates.pfx"

En este ejemplo se exporta el certificado "Certificado de sitios de equipo" y su clave privada, así como otros certificados de su cadena de certificados, al archivo \\server\fileshare\certificates.pfx.

------------EXAMPLE 2-----------

Export-SPCertificate -Identity "Team Sites Certificate" -Type Cert

En este ejemplo se exporta el certificado "Certificado de sitios de equipo" a un archivo de certificado almacenado en Administración central.

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

-EncryptionType

Especifica el algoritmo de cifrado que se va a usar para proteger el archivo PFX exportado. AES256 especifica que se usará el cifrado AES-256 con hash SHA256. TripleDes especifica que se usará el cifrado 3DES con hash SHA1. El cifrado AES-256 es más seguro que el cifrado 3DES, pero solo se admite con archivos PFX en Windows Server 2019 y sistemas operativos más recientes. Use el cifrado 3DES si el archivo PFX debe ser compatible con sistemas operativos anteriores. Si no se especifica este parámetro, se usa el cifrado AES-256 de forma predeterminada. Este parámetro solo es compatible con archivos PFX.

Type:String
Accepted values:AES256, TripleDes
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Especifica que se sobrescriba un archivo si ya existe en la ruta de acceso especificada.

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

-Identity

Certificado que se va a exportar.

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

-IncludeAllCertificatesInCertificationPath

Especifica si se van a exportar certificados adicionales que forman parte de la cadena de certificados del certificado especificado. Esto solo agregará certificados primarios del certificado especificado, no certificados secundarios emitidos por el certificado especificado. Este parámetro solo es compatible con archivos PFX y P7B.

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

-NoExtendedProperties

Especifica si no se deben exportar las propiedades extendidas del certificado, como el nombre descriptivo del certificado. Este parámetro solo es compatible con archivos PFX.

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

-Password

Contraseña que se va a usar para proteger el archivo PFX exportado. Este parámetro solo es compatible con archivos PFX.

Type:SecureString
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Path

Ruta de acceso al archivo PFX, P7B o CER al que se deben exportar los certificados.

Los certificados también se exportarán a un archivo de certificado almacenado en Administración central, independientemente de si se especifica este parámetro.

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

-Type

Especifica el tipo de archivo que se va a generar. El certificado generará un archivo CER que contiene un único certificado codificado en DER. Pkcs7 generará un archivo P7B (PKCS #7) que contiene uno o varios certificados. Este parámetro solo es compatible con archivos CER y P7B.

Type:String
Accepted values:Cert, Pkcs7
Position:Named
Default value:None
Required:True
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