Get-CsCertificate
上一次修改主题: 2012-03-23
返回有关本地计算机上已配置为与 Microsoft Lync Server 2010 配合使用的证书的信息。
语法
Get-CsCertificate [-NetportId <String>] [-Report <String>] [-Type <CertType[]>]
详细说明
Lync Server 2010 使用证书以供服务器和服务器角色验证其身份,例如,边缘服务器使用证书验证与其通信的计算机是否确实为前端服务器,反之亦然。要完整地实施 Lync Server,需要向相应的服务器角色分配相应的证书。
Get-CsCertificate cmdlet 提供了一种方式,用于检索有关已配置为与 Lync Server 配合使用的证书的详细信息。注意,此 cmdlet 仅返回有关 Lync Server 证书的信息。如果尚未(使用 Set-CsCertificate cmdlet)将证书配置为与 Lync Server 配合使用,则运行 Get-CsCertificate 时将不返回该证书。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Get-CsCertificate cmdlet:RTCUniversalServerAdmins。
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
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 |
NetportId |
可选 |
字符串 |
保留以供将来使用。此参数适用于特定端口专用的证书,但 Lync Server 还不支持这种情况。 |
Report |
可选 |
字符串 |
使您可以记录有关 Get-CsCertificate 执行的过程的详细信息。此参数值应为将生成的 HTML 文件的完整路径,例如:-Report C:\Logs\Certificates.html。如果指定的文件已存在,则该文件将自动被新信息覆盖。 |
输入类型
无。Get-CsCertificate 不接受通过管道传递的输入。
返回类型
Get-CsCertificate 返回 Microsoft.Rtc.Management.Deployment.CertificateReference 对象的实例。
示例
-------------------------- 示例 1 ------------------------
Get-CsCertificate
示例 1 中显示的命令返回有关当前分配给 Lync Server 组件的证书的信息。这一点是通过调用无任何其他参数的 Get-CsCertificate 实现的。
-------------------------- 示例 2 ------------------------
Get-CsCertificate -Type WebServicesInternal
示例 2 检索所有用于内部 Web 服务的 Lync Server 证书。为此,加入了 Type 参数以及参数值 WebServicesInternal。
-------------------------- 示例 3 ------------------------
Get-CsCertificate | Where-Object {$_.NotAfter -lt "9/1/2011"}
上述命令返回所有在 2011 年 9 月 1 日之前到期的 Lync Server 证书。为执行此任务,该命令首先使用 Get-CsCertificate 返回当前正在使用的所有 Lync Server 证书的集合。然后,将该集合通过管道传递到 Where-Object cmdlet,后者会仅选择在 2011 年 9 月 1 日之前到期的证书。此示例中指定的日期 (9/1/2011) 使用美国英语格式指定日期时间值。应使用与“区域和语言选项”兼容的格式指定日期。
-------------------------- 示例 4 ------------------------
Get-CsCertificate | Where-Object {$_.Issuer -eq "Cn=MyCa"}
示例 4 返回有关证书颁发机构 (CA) MyCa 颁发的所有 Lync Server 证书的信息。为此,该命令首先调用 Get-CsCertificate(无任何参数)返回当前正在使用的所有证书的集合。然后,将此集合通过管道传递给 Where-Object,后者选取 Issuer 属性等于 (-eq) "Cn=MyCa" 的所有证书。
-------------------------- 示例 5 ------------------------
Get-CsCertificate | Where-Object {$_.Subject -eq "CN=atl-cs-001.litwareinc.com"}
示例 5 中显示的命令返回已将 Subject 属性设置为 CN=atl-cs-001.litwareinc.com 的所有 Lync Server 证书。这一点是通过使用 Get-CsCertificate 返回所有 Lync Server 证书的集合,然后将该集合通过管道传递给 Where-Object cmdlet 实现的。Where-Object 转而仅选择 Subject 属性等于“CN=atl-cs-001.litwareinc.com”的那些证书。