Switch-SPCertificate
Reemplaza las asignaciones de certificados existentes por un nuevo certificado.
Syntax
Switch-SPCertificate
[-Identity] <SPServerCertificatePipeBind>
[-NewCertificate] <SPServerCertificatePipeBind>
[-AssignmentCollection <SPAssignmentCollection>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Es posible que desee reemplazar todo el uso de un certificado dentro de SharePoint por un certificado diferente. Por ejemplo, si un certificado existente se aproxima a su expiración y ha importado un nuevo certificado para reemplazarlo. Use el cmdlet Switch-SPCertificate para reemplazar las asignaciones de un certificado por otro. Todo el uso de ese certificado dentro de SharePoint se reemplazará por el certificado diferente.
Ejemplos
------------EJEMPLO-----------
Switch-SPCertificate -Identity "Team Sites Certificate (2020)" -NewCertificate "Team Sites Certificate (2021)"
En este ejemplo se reemplazan las asignaciones del certificado "Certificado de sitios de equipo (2020)" por el certificado "Certificado de sitios de equipo (2021)".
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 |
-Identity
Certificado cuyas asignaciones desea reemplazar.
Type: | SPServerCertificatePipeBind |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NewCertificate
Certificado que debe reemplazar todas las asignaciones del certificado especificado por el parámetro Identity.
Type: | SPServerCertificatePipeBind |
Position: | 1 |
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 |