Test-CsCertificateConfiguration
Topic Last Modified: 2012-03-25
Returns information about the Microsoft Lync Server 2010 certificates being used on the local computer.
Syntax
Test-CsCertificateConfiguration [-Report <String>]
Detailed Description
Test-CsCertificateConfiguration is an example of a "synthetic transaction." Synthetic transactions are used in Lync Server 2010 to verify that users are able to successfully complete common tasks such as logging on to the system, exchanging instant messages, or making calls to a phone located on the public switched telephone network (PSTN). These tests can be conducted manually by an administrator, or they can be automatically run by an application such as Microsoft System Center Operations Manager (formerly Microsoft Operations Manager).
Test-CsCertificateConfiguration returns information about the certificates being used by Lync Server 2010. The Test-CsCertificateConfiguration cmdlet is primarily intended for use by the Certificate wizard. It is recommended that administrators use Get-CsCertificate to retrieve certificate information.
Who can run this cmdlet: To return a list of all the role-based access control (RBAC) roles this cmdlet has been assigned to (including any custom RBAC roles you have created yourself), run the following command from the Windows PowerShell prompt:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsCertificateConfiguration"}
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
Report |
Optional |
String |
Enables you to specify a file path for the log file created when the cmdlet runs. For example: -Report "C:\Logs\Certificates.html". If this file already exists, it will be overwritten when you run the cmdlet. |
Verbose |
Optional |
Switch Parameter |
Reports detailed activity to the screen as the cmdlet runs. |
Input Types
None. Test-CsCertificateConfiguration does not accept pipelined input.
Return Types
Test-CsCertificateConfiguration returns instances of the Microsoft.Rtc.Management.Deployment,CertificateExists object.
Example
-------------------------- Example 1 --------------------------
Test-CsCertificateConfiguration
The command shown in Example 1 returns information about the certificates that are currently being used (on the local computer) by Lync Server 2010.
-------------------------- Example 2 --------------------------
Test-CsCertificateConfiguration -Report "C:\Logs\Certificates.xml"
The command shown in Example 2 is a variation of the command shown in Example 1. In this case, however, the Report parameter is used to specify a file path (C:\Logs\Certificates.xml) for the output file generated when you run Test-CsCertificateConfiguration.