Set-CsCertificate
上一次修改主题: 2012-03-26
让您可以将证书分配到 Microsoft Lync Server 2010 服务器或服务器角色。
语法
Set-CsCertificate -Reference <CertificateReference> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-NetportId <String>] [-Report <String>] [-Type <CertType[]>] [-WhatIf [<SwitchParameter>]]
Set-CsCertificate -Thumbprint <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-NetportId <String>] [-Report <String>] [-Type <CertType[]>] [-WhatIf [<SwitchParameter>]]
详细说明
Lync Server 2010 使用证书以供服务器和服务器角色验证其身份,例如,边缘服务器使用证书验证与其通信的计算机是否确实为前端服务器,反之亦然。为了完全实现 Lync Server,您需要将合适的证书分配给合适的服务器角色。
通过 Set-CsCertificate cmdlet,管理员可以将证书分配给服务器或服务器角色。请注意,只能对已配置用于 Lync Server 的证书进行分配。要标识哪些证书可用于分配,请使用 Get-CsCertificate cmdlet。
谁能运行此 cmdlet:必须是本地管理员才能在本地运行 Set-CsCertificate cmdlet。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsCertificate"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
NetportId |
可选 |
字符串 |
保留以供将来使用。此参数对专用于特定端口的证书适用,此方案目前还不受 Lync Server 支持。 |
Reference |
可选 |
证书参考对象 |
引用配置用于 Lync Server 的证书的对象。以下命令返回的对象引用(变量 $x)表示指纹为 B142918E463981A76503828BB1278391B716280987B 的证书: $x = Get-CsCertificate | Where-Object {$_.Thumbprint –eq "B142918E463981A76503828BB1278391B716280987B"。 |
Thumbprint |
可选 |
字符串 |
证书的唯一标识符。证书指纹类似于:B142918E463981A76503828BB1278391B716280987B。 |
Type |
可选 |
字符串 |
所分配的证书的类型。证书类型包括,但不限于: AccessEdgeExternal AudioVideoAuthentication DataEdgeExternal Default External Internal iPhoneAPNService iPadAPNService MPNService PICWebService(仅 Microsoft Lync Online 2010) ProvisionService(仅 Microsoft Lync Online 2010) WebServicesExternal WebServicesInternal WsFedTokenTransfer 例如,以下语法分配默认证书:-Type Default。 可以在单个命令中通过用逗号分隔证书类型来指定多种类型: -Type Internal,External,Default |
Force |
可选 |
开关参数 |
取消显示命令运行过程中可能出现的任何非致命错误消息。 |
Report |
可选 |
字符串 |
可以让您记录有关 Set-CsCertificate 执行的过程的详细信息。参数值应当是要生成的 HTML 文件的完整路径;例如:-Report C:\Logs\Certificates.html。如果指定的文件已存在,它将被新信息自动覆盖。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.Deployment.CertificateReference。
返回类型
Set-CsCertificate 不会返回任何值或对象。
示例
-------------------------- 示例 1 ------------------------
Set-CsCertificate -Type WebServicesExternal -Thumbprint "B142918E463981A76503828BB1278391B716280987B"
示例 1 中显示的命令将指纹 B142918E463981A76503828BB1278391B716280987B 的证书分配给本地计算机的 WebServicesExternal 角色。
-------------------------- 示例 2 ------------------------
Set-CsCertificate -Type Default, WebServicesInternal, WebServicesExternal -Thumbprint "B142918E463981A76503828BB1278391B716280987B"
上述命令将指纹 B142918E463981A76503828BB1278391B716280987B 的证书分配给本地计算机的三个不同角色:默认、WebServicesInternal 和 WebServicesExternal。