Switch-SPCertificate

Referencia

Módulo:: sharepoint-server

Se aplica a:: SharePoint Server Subscription Edition

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