Remove-CsCertificate

 

上一次修改主题: 2012-03-26

删除先前标记为可供 Microsoft Lync Server 2010 使用的证书。

语法

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

详细说明

Lync Server 2010 使用证书以供服务器和服务器角色验证其身份,例如,边缘服务器使用证书验证与其通信的计算机是否确实为前端服务器,反之亦然。为了完全实现 Lync Server,您需要将合适的证书分配给合适的服务器角色。

Remove-CsCertificate cmdlet 提供了一种删除 Lync Server 当前正在使用的证书的方法。Remove-CsCertificate 实际上不会删除证书本身,而只将证书标记为无法再供 Lync Server 使用,删除所有证书绑定并撤消对证书的访问权限(假设没有其他服务正在使用证书)。此外,这还意味着当您运行 Get-CsCertificate cmdlet 时,将不再显示该证书。

要再次将该证书与 Lync Server 组合使用,您需要使用 Set-CsCertificate cmdlet 重新将证书分配给 Lync Server 2010。

如果尝试删除当前正在使用的证书,Remove-CsCertificate 将会询问您是否确定要删除该证书;在响应该提示之前,无法删除证书。要绕过提示并以静默方式删除证书(即使证书当前正在使用),请将 Force 参数添加到命令中:

Remove-CsCertificate –Type WebServicesExternal -Force

谁能运行此 cmdlet:必须是本地管理员,并且是域成员,才能在本地运行 Remove-CsCertificate cmdlet。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:

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

参数

参数 必需 类型 描述

Type

可选

字符串

要删除的证书类型。证书类型包括(但不限于):

AccessEdgeExternal

AudioVideoAuthentication

DataEdgeExternal

Default

External

Internal

PICWebService(仅 Microsoft Lync Online 2010)

ProvisionService(仅 Microsoft Lync Online 2010)

WebServicesExternal

WebServicesInternal

WsFedTokenTransfer

例如,以下语法将删除 Default 证书:-Type Default。

可以在单个命令中通过用逗号分隔证书类型来删除多种类型:

-Type Internal,External,Default

NetportId

可选

字符串

保留以供将来使用。此参数适用于特定端口的专用证书(Lync Server 尚不支持此方案)。

Force

可选

开关参数

绕过尝试删除当前正在使用的证书时通常会出现的确认提示。

Report

可选

字符串

使您可以记录有关由 Remove-CsCertificate 执行的过程的详细信息。参数值应该为要生成的 HTML 文件的完整路径,例如:-Report C:\Logs\Certificates.html。如果指定的文件已存在,则该文件将自动被新信息覆盖。

WhatIf

可选

开关参数

描述如果执行命令会发生什么情况(无需实际执行命令)。

Confirm

可选

开关参数

在执行命令之前提示您进行确认。

输入类型

无。Remove-CsCertificate 不接受通过管道传递的输入。

返回类型

无。Remove-CsCertificate 会删除 Microsoft.Rtc.Management.Deployment.CertificateReference 对象的实例。

示例

-------------------------- 示例 1 --------------------------

Remove-CsCertificate -Type WebServicesExternal

示例 1 中显示的命令删除 Lync Server 可用的所有 WebServicesExternal 证书。如果当前正在使用其中任何证书,Remove-CsCertificate 将会询问您是否确定要删除该证书;您必须响应该提示,才能完成命令。要绕过确认提示,请使用 Force 参数:

Remove-CsCertificate –Type WebServicesExternal -Force