Topic Last Modified: 2013-03-07

Returns information about the Lync Server certificates being used on the local computer. This cmdlet was introduced in Lync Server 2010.

Syntax

Test-CsCertificateConfiguration [-Report <String>]

Examples

EXAMPLE 1

The command shown in Example 1 returns information about the certificates that are currently being used (on the local computer) by Lync Server.

Copy Code
Test-CsCertificateConfiguration

EXAMPLE 2

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 the Test-CsCertificateConfiguration cmdlet.

Copy Code
Test-CsCertificateConfiguration -Report "C:\Logs\Certificates.xml"

Detailed Description

The Test-CsCertificateConfiguration cmdlet is an example of a "synthetic transaction." Synthetic transactions are used in Lync Server 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).

The Test-CsCertificateConfiguration cmdlet returns information about the certificates being used by Lync Server. The Test-CsCertificateConfiguration cmdlet is primarily intended for use by the Certificate wizard. It is recommended that administrators use the Get-CsCertificate cmdlet 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

System.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.

Input Types

None. The Test-CsCertificateConfiguration cmdlet does not accept pipelined input.

Return Types

The Test-CsCertificateConfiguration cmdlet returns instances of the Microsoft.Rtc.Management.Deployment,CertificateExists object.

See Also