Share via


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.

See Also

Other Resources

Get-CsCertificate