Compartir a través de

  • Artículo

Remove-CsCertificate

 

Última modificación del tema: 2012-03-26

Quita un certificado marcado anteriormente como disponible para su uso por Microsoft Lync Server 2010.

Sintaxis

Remove-CsCertificate [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-NetportId <String>] [-Report <String>] [-Type <CertType[]>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Lync Server 2010 usa certificados para hacer que los servidores y los roles de servidor puedan comprobar sus identidades; por ejemplo, un Servidor perimetral usa certificados para comprobar que el equipo con el que se están comunicando realmente sea un Servidor front-end y viceversa. Para implementar Lync Server completamente, deberá tener los certificados correctos asignados a los roles de servidor correspondientes.

El cmdlet Remove-CsCertificate permite quitar los certificados que actualmente están en uso por parte de Lync Server. Remove-CsCertificate no elimina realmente el certificado, sino que lo marca para indicar que ya no está disponible para Lync Server, quita todos los enlaces con el certificado y revoca los permisos de acceso al certificado (suponiendo que ningún otro servicio va a usar el certificado). Esto significa, por ejemplo, que el certificado no volverá a aparecer cuando se ejecute el cmdlet Get-CsCertificate.

Para volver a usar el certificado con Lync Server, deberá volver a asignar el certificado a Lync Server 2010 utilizando el cmdlet Set-CsCertificate.

Si intenta quitar un certificado que está actualmente en uso, Remove-CsCertificate preguntará si está seguro de que desea quitar el certificado. El certificado no se quitará hasta que responda a la pregunta. Para eludir la pregunta y eliminar sigilosamente un certificado, incluso aunque esté en uso, agregue el parámetro Force al comando:

Remove-CsCertificate –Type WebServicesExternal -Force

Quién puede ejecutar este cmdlet: Para ejecutar el cmdlet Remove-CsCertificate localmente, es necesario ser administrador local y miembro del dominio. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsCertificate"}

Parámetros

Parámetro Requerido Tipo Descripción

Type

Opcional

Cadena de caracteres

Tipo de certificado que se debe eliminar. Entre los tipos de certificados se incluyen, sin limitaciones:

AccessEdgeExternal

AudioVideoAuthentication

DataEdgeExternal

Default

External

Internal

PICWebService (Microsoft Lync Online 2010 solamente)

ProvisionService (Microsoft Lync Online 2010 solamente)

WebServicesExternal

WebServicesInternal

WsFedTokenTransfer

Por ejemplo, esta sintaxis elimina el certificado Default: -Type Default.

Puede eliminar varios tipos con un solo comando separando los tipos de certificado con comas:

-Type Internal,External,Default

NetportId

Opcional

Cadena de caracteres

Reservado para uso futuro. Este parámetro es para certificados dedicados a un puerto específico, una opción que Lync Server todavía no admite.

Force

Opcional

Parámetro modificador

Elude la pregunta de confirmación que suele presentarse cuando se intenta eliminar un certificado que está actualmente en uso.

Report

Opcional

Cadena de caracteres

Permite registrar información detallada sobre los procedimientos llevados a cabo por Remove-CsCertificate. El valor del parámetro debe ser la ruta completa al archivo HTML que se debe generar; por ejemplo: -Report C:\Registros\Certificates.html. Si el archivo especificado ya existe, se sobrescribirá automáticamente con la nueva información.

WhatIf

Opcional

Parámetro modificador

Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente.

Confirm

Opcional

Parámetro modificador

Solicita confirmación antes de ejecutar el comando.

Tipos de entrada

Ninguno. Remove-CsCertificate no acepta la entrada transferida.

Tipos de valores devueltos

Ninguno. En lugar de eso, Remove-CsCertificate elimina las instancias del objeto Microsoft.Rtc.Management.Deployment.CertificateReference.

Ejemplo

-------------------------- Ejemplo 1 ------------------------

Remove-CsCertificate -Type WebServicesExternal

El comando del Ejemplo 1 elimina todos los certificados WebServicesExternal disponibles para Lync Server. Si alguno de estos certificados se está usando en estos momentos, Remove-CsCertificate le preguntará si está seguro de que desea quitar el certificado. Tendrá que responder a la pregunta para que se lleve a cabo el comando. Para eludir la pregunta de confirmación, utilice el parámetro Force:

Remove-CsCertificate –Type WebServicesExternal -Force