Switching between the Skype for Business and the Lync client user interfaces

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.

For Skype for Business Online organizations, you can use the Remote PowerShell in Microsoft 365 or Office 365 to enable your Skype for Business users to use the Skype for Business client or the Skype for Business (Lync) client user interface. The default setting is for users to use the Skype for Business client user interface. If you'd prefer to use the Lync client experience, you can manage the first launch client behavior to display the Lync user interface by following the steps later in this article.

Note

The Lync 2013 client experience isn't an option for Skype for Business 2016 client versions. Before you attempt to configure your client environment to use the Lync 2013 client, please check the client version to ensure it does not start with the number 16; for example: 16.x.x.x.

Tip

If you want to easily switch the user interface and don't want to do the manual steps, see the Microsoft Download Center for a PowerShell script to make it easier.

Switching the Skype for Business user interface for users

The Windows PowerShell module for Skype for Business Online enables you to create a remote Windows PowerShell session that connects to Skype for Business Online. This module, which is supported only on 64-bit computers can be downloaded from the Microsoft Download Center at Download and install the Teams PowerShell module. For other information, see Configuring your computer for Skype for Business Online management.

Important

The Global policy setting for switching the user interface won't be applied to a user that already has a custom policy applied. To be able to change the user interface, you will need to run the following for each user that has a custom policy applied:

Grant-CsClientPolicy -PolicyName ClientPolicyEnableSkypeUI -Identity <username>

Caution

The ClientPolicyEnableSkypeUI policy will replace the existing custom policy setting for the user.

To enable all of the users in your organization to use the Skype for Business client, open the Remote PowerShell and type the following:

Grant-CsClientPolicy -PolicyName ClientPolicyEnableSkypeUI

If you set the policy right, you'll see:

PowerShell: SkypeUIEnabled.

To enable all of the users in your organization to use the Skype for Business (Lync) client, open the Remote PowerShell and type the following:

Grant-CsClientPolicy -PolicyName ClientPolicyDisableSkypeUI

If you set the policy right, you'll see:

PowerShell: SkypeUIDisabled.

To allow a single user in your organization to use the Skype for Business client, open the Remote PowerShell and type the following:

Grant-CsClientPolicy -PolicyName ClientPolicyEnableSkypeUI -Identity <username>

If you set the policy right, you'll see:

Skype for Business Online - Enable UI.

To allow a single user in your organization to use the Skype for Business (Lync) client, open the Remote PowerShell and type the following:

Grant-CsClientPolicy -PolicyName ClientPolicyDisableSkypeUI -Identity <username>

If you set the policy right, you'll see:

Skype for Business Online - UI Disabled.

To allow multiple users in your organization to use the Skype for Business client, open the Remote PowerShell and type the following:

$users = @("sip:bob@contoso.com","sip:fred@contoso.com") 

$users | Grant-CsClientPolicy -PolicyName ClientPolicyEnableSkypeUI

To allow multiple users in your organization to use the Skype for Business (Lync) client, open the Remote PowerShell and type the following:

$users = @("sip:bob@contoso.com","sip:fred@contoso.com")

$users | Grant-CsClientPolicy -PolicyName ClientPolicyDisableSkypeUI

To allow a group of users in your organization to use the Skype for Business client, open the Remote PowerShell and type the following:

Get-CsOnlineUser -Filter {Department -eq "Sales"} | Grant-CsClientPolicy -PolicyName ClientPolicyEnableSkypeUI

To allow a group of users in your organization to use the Skype for Business (Lync) client, open the Remote PowerShell and type the following:

Get-CsOnlineUser -Filter {Department -eq "Sales"} | Grant-CsClientPolicy -PolicyName ClientPolicyDisableSkypeUI

Note

The user's name is the name of the user's account that the policy should be assigned to. The user's account name can be entered in one of the following formats:> SIP address of the user> User Principal name (UPN) of the user> Domain\username of the user> Active Directory display name of the user

Using Windows PowerShell to manage Lync Online

Skype for Business Online policy settings

This table shows the user experience when the policy is first applied to users:

Admin policy setting User interface displayed
The policy isn't set. The user continues using the Skype for Business client user interface.
Grant-CsClientPolicy -PolicyName ClientPolicyEnableSkypeUI The user continues using the Skype for Business client user interface.
Grant-CsClientPolicy -PolicyName ClientPolicyDisableSkypeUI The user is asked to switch to the Skype for Business (Lync) client user interface. They can switch later.
Grant-CsClientPolicy -PolicyName ClientPolicyEnableSkypeUI -Identity <username> The user is using the Skype for Business client user interface.
Grant-CsClientPolicy-PolicyName ClientPolicyDisableSkypeUI -Identity <username> The user is asked to switch to the Skype for Business (Lync) client user interface. An admin can change the setting in the future that switches them to the Skype for Business client user interface.

This table shows the user experience when the policy is changed:

Admin policy setting Skype for Business (Lync) user interface Skype for Business user interface
Grant-CsClientPolicy -PolicyName ClientPolicyEnableSkypeUI The user is asked to switch to the Skype for Business client user interface. The user continues to use the Skype for Business client user interface.
Grant-CsClientPolicy -PolicyName ClientPolicyDisableSkypeUI The user continues to use the Skype for Business (Lync) interface. The user is asked to switch to the Skype for Business (Lync) client user interface.
The policy isn't set. Users will never see the Skype for Business (Lync) client user interface if the policy isn't set. They'll always use the Skype for Business client user interface. The user continues to use the Skype for Business client user interface.

This table shows all the Online custom policies available. There are new policies created to give admins flexibility in retaining the old custom policy while switching between the EnableSkypeUI flags. Please use the cmdlets from above to grant one of the below policies to your users.

Policy name EnableSkypeUI
ClientPolicyDefaultPhoto
ClientPolicyDefaultPhotoDisableSkypeUI False
ClientPolicyNoIMURL
ClientPolicyNoIMURLDisableSkypeUI False
ClientPolicyNoIMURLPhoto
ClientPolicyNoIMURLPhotoDisableSkypeUI False
ClientPolicyNoSaveIMNoArchivingI
ClientPolicyNoSaveIMNoArchivingDisableSkypeUI False
ClientPolicyNoSaveIMNoArchivingNoIMURL
ClientPolicyNoSaveIMNoArchivingNoIMURLDisableSkypeUI False
ClientPolicyNoSaveIMNoArchivingNoIMURLPhoto
ClientPolicyNoSaveIMNoArchivingNoIMURLPhotoDisableSkypeUI False
ClientPolicyNoSaveIMNoArchivingPhoto
ClientPolicyNoSaveIMNoArchivingPhotoDisableSkypeUI False

To get started with Windows PowerShell, see these articles:

First launch client behaviors

By default, when users launch Skype for Business for the first time, they'll always see the Skype for Business user interface--even if you have selected the Lync client experience by setting the client policy to the Lync client experience (Grant-CsClientPolicy -PolicyName ClientPolicyDisableSkypeUI) as described previously. After several minutes, users will then be asked to switch to Lync mode.

If you want to display the Lync user interface when users launch the Skype for Business client for the first time, follow these steps before the client is started for the first time after being updated:

  1. Follow the steps earlier in this article and confirm that the client policy is set to disable the Skype for Business user interface.

  2. Update the system registry on the user's computer. You should do this before the first time users launch the Skype for Business client, and you should do this only once. For information about how to create a Group Policy Object to update the registry on a domain joined computer, see the section later in the article.

    In the [HKEY_CURRENT_USER\Software\Microsoft\Office\Lync] key, create a new Binary value.

    The Value name must be EnableSkypeUI, and the Value data must be set to 00 00 00 00.

    The key should look like the following:

    [HKEY_CURRENT_USER\Software\Microsoft\Office\Lync]

    "CanSharePptInCollab"=dword:00000001

    "CanShareOneNoteInCollab"=dword:00000001

    "CanAppShareInCollab"=dword:00000001

    "EnableSkypeUI"=hex:00,00,00,00

The Lync user interface will now be displayed when users launch the Skype for Business client for the first time.

Control the display of the Welcome screen tutorial

When users open the Skype for Business client, the default behavior is to display a Welcome screen that includes 7 Quick tips most people ask for. You can turn off the display of the Welcome screen but still allow users to access the tutorial by adding the following Registry value on the client computer:

In the [HKEY_CURRENT_USER\Software\Microsoft\Office\15.0\Lync] key, create a new DWORD (32-bit) Value. The Value name must be IsBasicTutorialSeenByUser, and the Value data must be set to 1.

The key should look like the following:

"IsBasicTutorialSeenByUser"=dword:00000001

Turn off the client tutorial

If you don't want your users to be able to access the tutorial, you can turn off the client tutorial with the following Registry value:

In the [HKEY_CURRENT_USER\Software\Microsoft\Office\15.0\Lync] key, create a new DWORD (32-bit) Value. The Value name must be TutorialFeatureEnabled, and the Value data must be set to 0.

"TutorialFeatureEnabled"=dword:00000000

You can turn the tutorial back on by setting the Value data to 1.

Create a Group Policy Object to modify the registry on a domain joined computer

The registry update to display the Lync client experience the first time a user launches the Skype for Business client should be done only once. If you use a Group Policy Object (GPO) to update the registry, you need to define the object to create a new value rather than update the Value data. When the GPO is applied, if the new value doesn't exist, the GPO creates it and sets the Value data to 0.

The following procedure describes how to modify the registry so that the Lync client experience is displayed the first time a user launches the Skype for Business. You can also use this procedure to update the registry to disable the Welcome screen tutorial as described earlier.

To create the GPO

  1. Start the Group Policy Management console.

    For information about how to use the Group Policy Management Console, see Group Policy Management Console.

  2. Right-click the Group Policy Objects node and select New on the menu.

  3. In the New GPO dialog, enter a name for the GPO, for example,MakeLyncDefaultUI, and then select OK.

  4. Right-click on the new GPO you just created and then select Edit from the menu.

  5. In the Group Policy Management Editor, expand User Configuration, expand Preferences, expand Windows Settings, and then select the Registry node.

  6. Right-click on the Registry node, and then select New > Registry Item.

  7. On the New Registry Properties dialog, update the following:

Field Value to select or enter
Action Create
Hive HKEY_CURRENT_USER
Key Path Software\Microsoft\Office\Lync
Value name EnableSkypeUI
Value type REG_BINARY
Value data 00000000

Click OK to save your changes, and then close the GPO.

Next, you need to link the GPO you created to the group of users that you want to assign the policy to, such as an OU.

To use the GPO to assign the policy

  1. In the Group Policy Management Console, right-click on the OU you want to assign the policy to, and then select Link to an existing GPO.

  2. On the Select GPO dialog, select the GPO you created, and then select OK.

  3. On the target user's computer, open a command prompt and type the following command:

    gpupdate /target:user

    The message "Updating policy..." is displayed while the GPO is applied. When it's completed, the message "User Policy update has completed successfully" is displayed.

  4. At the command prompt, type the following command:

    gpresult /r

    You should see "Assigned Group Policy Objects" with the name of the GPO you created displayed below.

You can also verify that the GPO has successfully updated the registry on a user's computer by examining the registry. Open Registry Editor and navigate to the [HKEY_CURRENT_USER\Software\Microsoft\Office\Lync] key. If the GPO successfully updated the registry you'll see a value named EnableSkypeUI with a value of 0.

Set up Skype for Business Online

Let Skype for Business users add Skype contacts