See Also
Topic Last Modified: 2013-02-22
Returns information about the User Services configuration settings in use in your organization. The User Services service helps maintain presence information and manage conferencing. This cmdlet was introduced in Lync Server 2010.
Syntax
Get-CsUserServicesConfiguration [-Identity
<XdsIdentity>] <COMMON PARAMETERS>
|
Get-CsUserServicesConfiguration [-Filter <String>]
<COMMON PARAMETERS>
|
COMMON PARAMETERS: [-LocalStore
<SwitchParameter>]
|
Examples
EXAMPLE 1
The command shown in Example 1 returns a collection of all the User Services configuration settings currently in use in the organization. This is achieved by calling the Get-CsUserServicesConfiguration cmdlet without any additional parameters.
 Copy Code |
|
|---|---|
Get-CsUserServicesConfiguration |
|
EXAMPLE 2
In Example 2, only one collection of User Services configuration settings is returned: the collection with the Identity site:Redmond. Because identities must be unique, this command can never return more than one item.
| Copy Code |
|
|---|---|
Get-CsUserServicesConfiguration -Identity site:Redmond |
|
EXAMPLE 3
Example 3 returns a collection of all the User Services configuration settings that have been applied at the service scope. This is done by calling the Get-CsUserServicesConfiguration cmdlet along with the -Filter parameter; the filter value "service:*" limits the returned data to settings where the Identity begins with the characters "service:". By definition, those are settings configured at the service scope.
| Copy Code |
|
|---|---|
Get-CsUserServicesConfiguration -Filter "service:*" |
|
EXAMPLE 4
Example 4 returns all the User Services configuration settings that allow users to have more than 250 contacts. To do this, the command first calls the Get-CsUserServicesConfiguration cmdlet without any additional parameters in order to return a collection of all the User Services configuration settings currently in use. That collection is then piped to the Where-Object cmdlet, which picks out only those settings where the MaxContacts property is greater than 250.
| Copy Code |
|
|---|---|
Get-CsUserServicesConfiguration | Where-Object {$_.MaxContacts -gt 250}
|
|
EXAMPLE 5
In Example 5, information is reported for those User Services configuration settings where the anonymous user grace period is longer than 10 minutes. To carry out this task, the command first calls the Get-CsUserServicesConfiguration cmdlet without any additional parameters; this returns a collection of all the User Services configuration settings being used in the organization. The returned collection is then piped to the Where-Object cmdlet, which selects only the settings where the AnonymousUserGracePeriod property is greater than 10 minutes (00 hours: 10 minutes: 00 seconds).
| Copy Code |
|
|---|---|
Get-CsUserServicesConfiguration | Where-Object {$_.AnonymousUserGracePeriod -gt "00:10:00"}
|
|
Detailed Description
Lync Server relies on the User Services service to help maintain presence information for users and to manage meetings and conferences. In turn, the CsUserServicesConfiguration cmdlets are used to administer User Services settings at the global, site, and service scope. (Note that the only service that can host User Services configuration settings is the User Services itself.) These settings help determine such things as the number of contacts a user can have, the number of meetings a user can have scheduled at any one time, and the length of time that a given meeting can remain active.
The Get-CsUserServicesConfiguration cmdlet provides a way for administrators to retrieve information about any (or all) of the User Services configuration settings currently in use.
Who can run this cmdlet: By default, members of the following groups are authorized to run the Get-CsUserServicesConfiguration 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-CsUserServicesConfiguration"}
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
Filter |
Optional |
System.String |
Enables you to use wildcards when retrieving one or more collections of User Services 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:*". |
|
Identity |
Optional |
Microsoft.Rtc.Management.Xds.XdsIdentity |
Unique identifier for the User Services 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:UserServer:atl-cs-001.litwareinc.com. If this parameter is omitted then the Get-CsUserServicesConfiguration cmdlet returns all the User Services configuration settings currently in use in your organization. |
|
LocalStore |
Optional |
System.Management.Automation.SwitchParameter |
Retrieves the User Services configuration data from the local replica of the Central Management store rather than from the Central Management store itself. |
Input Types
None. The Get-CsUserServicesConfiguration cmdlet does not accept pipelined input.
Return Types
The Get-CsUserServicesConfiguration cmdlet returns instances of the Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.UserServicesSettings object.
