Manage user accounts

Important

Skype for Business Online operated by 21Vianet in China will be retired on October 1, 2023. If you haven't upgraded your Skype for Business Online users yet, they will be automatically scheduled for an assisted upgrade. If you want to upgrade your organization to Teams yourself, we strongly recommend that you begin planning your upgrade path today. Remember that a successful upgrade aligns technical and user readiness, so be sure to leverage our upgrade guidance as you navigate your journey to Teams.

Skype for Business Online, excluding the service operated by 21Vianet in China, was retired on July 31, 2021.

Manage user accounts

This topic contains the following sections:

Note

The Set-CsUser cmdlet is also included in the set of cmdlets available to Skype for Business Online admins. However, Set-CsUser cannot currently be used to manage Skype for Business Online, except for setting the AudioVideoDisabled parameter. If you attempt to run the cmdlet with any other parameter, it will fail with an error message similar to this: Unable to set "SipAddress". This parameter is restricted within Remote Tenant PowerShell.

Return information about all your Skype for Business Online users

To return information about all your users who have been enabled for Skype for Business Online, call the Get-CsOnlineUser cmdlet without any additional parameters.

Get-CsOnlineUser

To return information for a single, randomly selected user (for example, to use this account for test purposes), call the Get-CsOnlineUser cmdlet and set the ResultSize parameter to 1.

Get-CsOnlineUser -ResultSize 1

That causes the Get-CsOnlineUser cmdlet to return information for just one user, regardless of how many users you have in your organization. To return information for five users, set the value of the ResultSize parameter to 5.

Get-CsOnlineUser -ResultSize 5

Return information for a specific user in Skype for Business Online

There are multiple ways of referencing a specific user account when calling the Get-CsOnlineUser cmdlet. You can use the user's Active Directory Domain Services (AD DS) display name.

Get-CsOnlineUser -Identity "Ken Myer"

You can use the user's SIP address.

Get-CsOnlineUser -Identity "sip:kenmyer@litwareinc.com"

You can use the user's user principal name (UPN).

Get-CsOnlineUser -Identity "kenmyer@litwareinc.com"

Return specific information for specific users in Skype for Business Online

By default, the Get-CsOnlineUser cmdlet returns a huge amount of information for each Skype for Business Online user account. If you are interested in only a subset of that information, pipe the returned data to the Select-Object cmdlet. For example, this command returns all the data for the user Ken Myer, and then uses the Select-Object cmdlet to limit the information displayed onscreen to Ken's AD DS display name and dial plan.

Get-CsOnlineUser -Identity "Ken Myer" | Select-Object DisplayName, DialPlan

The following command returns the display name and dial plan for all your users.

Get-CsOnlineUser | Select-Object DisplayName, DialPlan

To find the properties of a Skype for Business Online user account, use the following command.

Get-CsOnlineUser | Get-Member

Return a filtered list of users in Skype for Business Online

By using the Get-CsOnlineUser cmdlet and the LdapFilter or Filter parameters, you can easily return information about a targeted set of users. For example, this command returns all the users who work in the Finance department.

Get-CsOnlineUser -LdapFilter "department=Finance"

Set up your computer for skype for business online management using Windows PowerShell