Remove-CsUserAcp
Removes one or more audio conferencing providers assigned to a user or group of users. This cmdlet was introduced in Lync Server 2010.
Syntax
Remove-CsUserAcp
[-Identity] <UserIdParameter>
[-Name <String>]
[-TollNumber <String>]
[-PassThru]
[-WhatIf]
[-Confirm]
[-ParticipantPasscode <String>]
[<CommonParameters>] Description
Deprecation Notice: Integration of Skype for Business with third-party audio conferencing providers has been retired. More details are here - https://learn.microsoft.com/skypeforbusiness/legal-and-regulatory/end-of-integration-with-3rd-party-providers. As a result, cmdlet no longer works.
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.
Skype for Business Server does not allow for complete integration with audio conferencing providers. The CsUserAcp cmdlets do 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 Skype for Business Server (instead, they are primarily intended for use with Skype for Business Online) no additional audio conferencing provider integration is provided beyond assigning property values.
Any audio conferencing provider assigned to a user can later be removed by using the Remove-CsUserAcp cmdlet.
Calling the Remove-CsUserAcp cmdlet without any parameters (other than the Identity parameter, which indicates the user account to be modified) removes all the audio conferencing providers assigned to a user.
Alternatively, you can use the optional parameters included with the Remove-CsUserAcp cmdlet to remove selected providers from a user account.
For example, this command finds the Ken Myer user account and removes all the audio conferencing providers that have a Name equal to "Fabrikam ACP":
Remove-CsUserAcp -Identity "Ken Myer" -Name "Fabrikam ACP"
To provide finer-grained removal of audio conferencing providers, simply include additional parameters. For example this command removes any audio conferencing providers that have the Name "Fabrikam ACP" and also have a TollNumber equal to "14255551298" as follows:
Remove-CsUserAcp -Identity "Ken Myer" -Name "Fabrikam ACP" -TollNumber "14255551298"
Examples
-------------------------- Example 1 ------------------------
Remove-CsUserAcp -Identity "Ken Myer"The command shown in Example 1 removes all the audio conferencing providers that have been assigned to the user Ken Myer.
-------------------------- Example 2 ------------------------
Get-CsUser | Remove-CsUserAcpExample 2 shows how you can remove all of the audio conferencing providers that have been assigned to all the users enabled for Skype for Business Server.
To do this, the command first uses the Get-CsUser cmdlet to retrieve a collection of all the users who have been enabled for Skype for Business Server.
That collection is then piped to the Remove-CsUserAcp cmdlet, which removes all the audio conferencing providers that have been assigned to each user in the collection.
-------------------------- Example 3 ------------------------
Remove-CsUserAcp -Identity "Ken Myer" -Name "Fabrikam ACP"In Example 3, all the audio conferencing providers that have the Name "Fabrikam ACP" are removed from Ken Myer's user account.
-------------------------- Example 4 ------------------------
Get-CsUserAcp | Where-Object {$_.AcpInfo -match "14255551298"} | Remove-CsUserAcpExample 4 removes the audio conferencing provider that has the toll number "14255551298" from all the user accounts that have been assigned an audio conferencing provider.
To carry out this task, the command first uses the Get-CsUserAcp cmdlet to return information about all the audio conferencing providers assigned to all your users.
This information is then piped to the Where-Object cmdlet, which selects only those accounts where the AcpInfo property includes (-match) the telephone number "14255551298".
This filtered collection is then piped to the Remove-CsUserAcp cmdlet, which removes the corresponding audio conferencing provider from each account in the filtered collection.
Parameters
-Confirm
Prompts you for confirmation before executing the command.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Lync Server 2010, Lync Server 2013, Skype for Business Online, Skype for Business Server 2015, Skype for Business Server 2019 |
-Identity
Indicates the Identity of the user account from which the audio conferencing provider is to be removed. You can specify a user's identity using one of four formats: 1) the user's SIP address; 2) the user's user principal name (UPN); 3) the user's domain name and logon name, in the form domain\logon (for example, litwareinc\kenmyer) and 4) the user's Active Directory Domain Services display name (for example, Ken Myer). User Identities can also be reference by using the user's Active Directory distinguished name.
You can use the asterisk () wildcard character when using the Display Name as the user Identity. For example, the Identity " Smith" returns all the users with a display name that ends with the string value " Smith".
| Type: | UserIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Lync Server 2010, Lync Server 2013, Skype for Business Online, Skype for Business Server 2015, Skype for Business Server 2019 |
-Name
Name of the audio conferencing provider. For example:
-Name "Fabrikam Conference Services"
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Lync Server 2010, Lync Server 2013, Skype for Business Online, Skype for Business Server 2015, Skype for Business Server 2019 |
-ParticipantPasscode
Passcode required when connecting to a conference by using the audio conferencing provider. For example:
-PassCode "0712"
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Lync Server 2010, Lync Server 2013, Skype for Business Online, Skype for Business Server 2015, Skype for Business Server 2019 |
-PassThru
Enables you to pass a user object through the pipeline that represents the user who is having the audio conferencing provider removed.
By default, the Remove-CsUserAcp cmdlet does not pass objects through the pipeline.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Lync Server 2010, Lync Server 2013, Skype for Business Online, Skype for Business Server 2015, Skype for Business Server 2019 |
-TollNumber
Non-toll-free phone number used for audio conferences. For example:
-TollNumber "14255551298"
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Lync Server 2010, Lync Server 2013, Skype for Business Online, Skype for Business Server 2015, Skype for Business Server 2019 |
-WhatIf
Describes what would happen if you executed the command without actually executing the command.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Lync Server 2010, Lync Server 2013, Skype for Business Online, Skype for Business Server 2015, Skype for Business Server 2019 |
Inputs
String or Microsoft.Rtc.Management.ADConnect.Schema.ADUser object.
The Remove-CsUserAcp cmdlet accepts a pipelined string value representing the Identity of a user account that has been enabled for Skype for Business Server.
The cmdlet also accepts pipelined instances of the Active Directory user object.
Outputs
None.