Topic Last Modified: 2010-10-01

Returns information about the Registrar configuration settings currently in use in your organization. Registrars are used to authenticate logon requests and to maintain information about user status and availability.

Syntax

Get-CsRegistrarConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsRegistrarConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Parameters

Parameter Required Type Description

Identity

Optional

Xds Identity

Unique identifier for the Registrar configuration settings to be returned. To return the global settings, use this syntax: -Identity global. To return settings configured at the site scope, use syntax similar to this: -Identity site:Redmond. To return settings at the service level, use syntax like this: -Identity service:Registrar:atl-cs-001.litwareinc.com.

If this parameter is omitted then Get-CsRegistrarConfiguration returns all of the Registrar configuration settings currently in use in your organization.

Filter

Optional

String

Enables you to use wildcards in order to return one or more collections of Registrar configuration settings. For example, to return all the settings configured at the site scope, use this syntax: -Filter "site:*". To return all the settings configured at the service scope, use this syntax: -Filter "service:*".

LocalStore

Optional

Switch Parameter

Retrieves the Registrar configuration settings data from the local replica of the Central Management store rather than from the Central Management store itself.

Detailed Description

The Registrar is perhaps the most important component in Microsoft Lync Server 2010; after all, without a Registrar, users would not be able to log on to the system, and Lync Server 2010 would not be able to keep track of users and their current status. When a user logs on to Lync Server, the endpoint the user is logging on from sends a REGISTER request to the Registrar; in turn, the server responds by challenging the client device for authentication credentials. If the client passes the challenge (that is, if the client presents a valid set of credentials), then the user is authenticated and endpoint information such as IP address, port, and user name is logged in the registration database. When a user logs off, this information is then removed from the database. In between log on and log off, the Registrar keeps status information up-to-date and helps to route messages to and from the user.

Registrar configuration settings are used to help manage endpoints and endpoint subscriptions; these settings can be applied at the global, site, or service scope. (Service scoped-settings can only be used with the Registrar service.) The Get-CsRegistrarConfiguration cmdlet is used to return information about all the Registrar configurations collections currently in use in your organization.

Who can run this cmdlet: By default, members of the following groups are authorized to run the Get-CsRegistrarConfiguration cmdlet locally: RTCUniversalUserAdmins, RTCUniversalServerAdmins. 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 "Get-CsRegistrarConfiguration"}

Input Types

None. Get-CsRegistrarConfiguration does not accept pipelined input.

Return Types

Get-CsRegistrarConfiguration returns instances of the Microsoft.Rtc.Management.WritableConfig.Settings.Registrar.RegistrarSettings object.

Example

-------------------------- Example 1 --------------------------

Copy Code
Get-CsRegistrarConfiguration

The command shown in Example 1 returns a collection of all the Registrar configuration settings currently in use in the organization.

-------------------------- Example 2 --------------------------

Copy Code
Get-CsRegistrarConfiguration -Identity site:Redmond

Example 2 returns a single collection of Registrar configuration settings: the settings configured for the Redmond site (-Identity site:Redmond).

-------------------------- Example 3 --------------------------

Copy Code
Get-CsRegistrarConfiguration -Filter "service:*"

In Example 3, information is returned for all the Registrar configuration settings assigned at the service scope. To do this, the command uses the Filter parameter and the filter value "service:*"; that filter value ensures that only settings that have an Identity that begins with the string value "service:" will be returned.

-------------------------- Example 4 --------------------------

Copy Code
Get-CsRegistrarConfiguration | Where-Object {$_.EnableDHCPServer -eq $True}

Example 4 returns information about the Registrar configuration settings that enable the use of DHCP servers in order to register clients. To carry out this task, the command first calls Get-CsRegistrarConfiguration without any parameters; that returns a collection of all the Registrar configuration settings currently in use. This collection is then piped to Where-Object, which selects only those settings where the EnableDHCPServer property is equal to True.

-------------------------- Example 5 --------------------------

Copy Code
Get-CsRegistrarConfiguration | Where-Object {$_.MaxEndpointsPerUser -gt 8}

In the preceding command, information is returned for all the Registrar configuration settings that allow more than eight endpoints per user. To accomplish this, the command first uses Get-CsRegistrarConfiguration to return a collection of all the Registrar configuration settings used in the organization. This collection is then piped to the Where-Object cmdlet, which picks out those settings where the MaxEndpointsPerUser property is greater than 8.

See Also