Parameters

An audio conferencing provider is a third-party company that provides organizations with conferencing services. Among other things, audio conferencing providers provide a way for users located off site, and not connected to the corporate network or the Internet, to participate in the audio portion of a conference or meeting. Audio conferencing providers often provide high-end services such as live translation, transcription, and live per-conference operator assistance.

Microsoft Lync Server 2010 does not allow for complete integration with audio conferencing providers. The CsUserAcp cmdlets enable administrators to set a phone number and passcode, and to configure other information that can be used for audio conferencing provider integration any time a user schedules a meeting. However, because these cmdlets were not designed for the on-premises version of Lync Server (instead, they are primarily intended for use with Microsoft Lync Online 2010) no additional audio conferencing provider integration is provided beyond assigning property values.

The Get-CsUserAcp cmdlet enables you to return information about the audio conferencing providers that have been assigned to a user or a group of users. To return audio conferencing provider information for a single user, simply include the Identity parameter followed by the Identity of the user whose information is to be returned. To return information for multiple users, you can use either the LdapFilter or the Filter parameters. The LdapFilter parameter enables you to use generic Active Directory attributes such as Department or Title when specifying user account information; for example, the parameter value "Title=Accountant" restricts the returned information to users who have the job title Accountant. The Filter parameter enables you to use Microsoft Lync Server 2010-specific attributes (for example, VoicePolicy or EnterpriseVoiceEnabled) to filter the returned data. For example, the filter value {EnterpriseVoiceEnabled –eq $True} limits the user accounts returned by Get-CsUserAcp to users who have been enabled for Enterprise Voice.

Alternatively, you can call Get-CsUserAcp without any parameters in order to return audio conferencing provider information for all your users. Note that Get-CsUserAcp returns audio conferencing provider information for all your users, including users who have not been enabled for Lync Server.

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

String. Get-CsUserAcp accepts a pipelined string value representing the Identity of a user account that has been enabled for Lync Server 2010.

Get-CsUserAcp returns instances of the Microsoft.Rtc.Management.ADConnect.Schema.ADUserAcp object.

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

	Copy Code
Get-CsUserAcp

The command shown in Example 1 returns audio conferencing provider information for all the users in your organization.

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

	Copy Code
Get-CsUserAcp -Identity "Ken Myer"

The preceding command returns audio conferencing provider information for a single user: the user with the Identity Ken Myer. In this case, the identity is specified by using the user’s Active Directory display name.

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

	Copy Code
Get-CsUserAcp -Filter {AcpInfo -ne $Null}

Example 3 returns information for all the users who have been assigned at least one audio conferencing provider. To do this, the Filter parameter is included along with the filter value {AcpInfo –ne $Null}; this filter value limits the returned data to users who have an AcpInfo property value that is not equal to a null value. To return information about users who have not been assigned an audio conferencing provider use this filter value:

{AcpInfo –eq $Null}

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

	Copy Code
Get-CsUserAcp | Where-Object {$_.AcpInfo -match "Fabrikam ACP"

The preceding command returns audio conferencing provider information for any user who has been assigned the audio conferencing provider Fabrikam ACP. To carry out this task the command first uses Get-CsUserAcp without any parameters in order to return audio conferencing provider information for all the users in your organization. This information is then piped to the Where-Object cmdlet, which picks out any user whose AcpInfo property includes (-match) the string value "Fabrikam ACP".

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

	Copy Code
Get-CsUserAcp -Identity "Ken Myer" | Select-Object -ExpandProperty AcpInfo

In Example 5, detailed information is displayed about the audio conferencing providers assigned to the user Ken Myer. To do this, Get-CsUserAcp is first called in order to return audio conferencing provider information for Ken Myer. This data is then piped to the Select-Object cmdlet, which uses the ExpandProperty parameter to “expand” the value of the AcpInfo property. When a property value is expanded, that means that all the information stored in that value is displayed in easy-to-read format.

Other Resources