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