Test-CsKerberosAccountAssignment
Topic Last Modified: 2012-03-26
Verifies the configuration of the Kerberos account assigned to a site.
Syntax
Test-CsKerberosAccountAssignment -Identity <XdsIdentity> [-Report <String>]
Detailed Description
In Microsoft Office Communications Server 2007 and Microsoft Office Communications Server 2007 R2, IIS ran under a standard user account. This had the potential to cause issues: if that password expired you could lose your Web Services, an issue that was often difficult to diagnose. To help avoid the issue of expiring passwords, Microsoft Lync Server 2010 enables you to create a computer account (for a computer that doesn’t actually exist) that can serve as the authentication principal for all the computers in a site that are running IIS. Because these accounts use the Kerberos authentication protocol, the accounts are referred to as Kerberos accounts, and the new authentication process is known as Kerberos web authentication. This enables you to manage all your IIS servers by using a single account.
The Test-CsKerberosAccountAssignment cmdlet provides a way for you to verify that a Kerberos account has been associated with a given site, that this account has been configured correctly, and that the account is working as expected.
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-CsKerberosAccountAssignment"}
Parameters
Parameter | Required | Type | Description |
---|---|---|---|
Identity |
Required |
String |
Name of the site where the Kerberos account was assigned. For example: -Identity "site:Redmond". |
Report |
Optional |
String |
Enables you to specify a file path for the log file created when the cmdlet runs. For example: -Report "C:\Logs\TestKerberos.html". |
Verbose |
Optional |
Switch Parameter |
Reports detailed activity to the screen as the cmdlet runs. |
Input Types
None. Test-CsKerberosAccountAssignment does not accept pipelined input.
Return Types
Test-CsKerberosAccountAssignment does not return any objects or values.
Example
-------------------------- Example 1 ------------------------
Test-CsKerberosAccountAssignment -Identity site:Redmond
The command shown in Example 1 verifies that the Kerberos account assigned to the Redmond site is configured correctly and is working as expected.