Remove-SPCertificate
Elimina un certificado y cualquier clave privada asociada.
Syntax
Remove-SPCertificate
[-Identity] <SPServerCertificatePipeBind>
[-Force]
[-AssignmentCollection <SPAssignmentCollection>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Elimina un certificado y cualquier clave privada asociada.
Lo siguiente ocurrirá cuando elimine un certificado de SharePoint:
De forma predeterminada, SharePoint no le permitirá eliminar un certificado si está asignado actualmente a un objeto de SharePoint. Debe invalidar el comportamiento predeterminado con el parámetro Force si desea forzar la eliminación de un certificado. Si invalida el comportamiento predeterminado, se borran las asignaciones existentes del certificado.
El certificado y cualquier clave privada asociada a ese certificado se eliminan del almacén de certificados de Windows en cada servidor de la granja de servidores de SharePoint.
El certificado y cualquier clave privada asociada a él se eliminan de la base de datos de configuración de SharePoint.
No se eliminarán las exportaciones anteriores del certificado a través de la interfaz de administración de SharePoint. Esos archivos exportados seguirán existiendo.
Ejemplos
------------EJEMPLO-----------
Remove-SPCertificate -Identity "Team Sites Certificate"
En este ejemplo se elimina el certificado "Certificado de sitios de equipo" y cualquier clave privada asociada a ese certificado.
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 |
-Force
Especifica que el certificado debe eliminarse de SharePoint, incluso si el certificado está asignado actualmente a objetos de SharePoint. Si se especifica este parámetro, también se borran las asignaciones existentes del certificado. Si no se especifica este parámetro y el certificado se asigna a un objeto de SharePoint, se producirá un error en la operación.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Identity
Certificado que se va a eliminar de SharePoint.
Type: | SPServerCertificatePipeBind |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
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 |