Patch for issue 8375: Replace legacy Skype for Business with new Teams PowerShell module

Summary:

Microsoft migrates from Skype for Business PowerShell module to the Teams PowerShell module and started to reject Skype for Business Online Connector connections starting May 17, 2021.

If you're using Skype For Business functionally in the Cayosoft Administrator you need to uninstall the legacy Skype For Business module, install the new Teams PowerShell module, and apply the patch to Office 365 extension. To obtain the patched extension please contact Cayosoft Support via Support@cayosoft.com.

Applies to: Cayosoft Administrator 8.1.0.

ID: KB20210520-1

Issue description

If the setting in Office 365 extension (Home > Configuration > Connected Systems Extensions > Microsoft Office 365) Connect to Skype Online service is set to Yes, Web Portal can produce the error below, also errors with ID 1002 and 1005 appear in Event Log > Application.

Error in Web Portal

The running command stopped because the preference variable "ErrorActionPreference" or common parameter is set to Stop: [admin4a.online.lync.com] Processing data from remote server admin4a.online.lync.com failed with the following error message: Skype for Business Online PowerShell connections are blocked. Please replace the Skype for Business Online PowerShell connector module with the Teams PowerShell Module. Please visit https://aka.ms/sfbocon2tpm for supported options. For more information, see the about_Remote_Troubleshooting Help topic.

Error in Event Log ID 1002

Fail to open connection to the target system Microsoft Office 365. PID: XXXX. Error: The running command stopped because the preference variable "ErrorActionPreference" or common parameter is set to Stop: [admin2a.online.lync.com] Processing data from remote server admin2a.online.lync.com failed with the following error message: Skype for Business Online PowerShell connections are blocked. Please replace the Skype for Business Online PowerShell connector module with the Teams PowerShell Module.  Please visithttps://aka.ms/sfbocon2tpm for supported options. For more information, see the about_Remote_Troubleshooting Help topic.

Error in Event Log ID 1005

Session creation failed. PID: XXXX. Reason: The running command stopped because the preference variable "ErrorActionPreference" or common parameter is set to Stop: [admin2a.online.lync.com] Processing data from remote server admin2a.online.lync.com failed with the following error message: Skype for Business Online PowerShell connections are blocked. Please replace the Skype for Business Online PowerShell connector module with the Teams PowerShell Module.  Please visit https://aka.ms/sfbocon2tpm for supported options. For more information, see the about_Remote_Troubleshooting Help topic..

Install .NET Framework 4.7.2

New Teams PowerShell module requires at least .NET Framework 4.7.2 version. So you need to determine the current .NET framework version and install v4.7.2 if it is needed:

1. Click the Windows Start icon.

2. Type ISE - you will see the Windows PowerShell ISE appears on the screen.

3. Right-click Windows PowerShell ISE and click Run As Administrator.

4. Run this PowerShell command to check the current version:

   (Get-ItemProperty "HKLM:\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full").Release -ge 461808 

5. If script returned True, you don't need to update your .NET Framework installation.
   More information How to determine which .NET Framework versions are installed you can find in this MS article.
6. If script returned False, you need to install .NET Framework 4.7.2 Runtime from here.

Uninstall legacy Skype for Business Online module and install the Teams module

To uninstall Skype For Business Online PowerShell module and install the new Teams module manually, perform the following steps:

1. Click the Windows Start icon.

2. Type ISE - you will see the Windows PowerShell ISE appears on the screen.

3. Right-click Windows PowerShell ISE and click Run As Administrator.

4. Stop Cayosoft Administrator service:

   Stop-Service CayoAdminService

5. In Windows Control Panel, open Programs and Features, find and uninstall Skype for Business Online, Windows PowerShell Module manually.
6. In Windows PowerShell ISE, run the following command to check your current MicrosoftTeams version: 

   Get-Module -Name MicrosoftTeams -ListAvailable | Select Name,Version

7. If the script returned a version lower than the latest released (2.3.1), you need to remove the previous version first:

   Uninstall-Module -Name MicrosoftTeams

8. Install the Teams module:

   Install-Module MicrosoftTeams

Apply patch to Office 365 extension

When you get the patched extension file you need to update your current expkg-extension file with the new one.

1. Ensure that the Administrator Console is closed and the service is stopped.
2. Open folder with Cayosoft extensions, by default it is C:\Program Files\Cayo Software\AdminAssistant\Extensions
3. Replace PM.Ext.O365.expkg with the unzipped one. You can keep the old file in some other place.
4. Start Cayosoft Administrator service in PowerShell ISE:

   Start-Service CayoAdminService

5. Open Administrator Console, navigate to Home > Configuration > Connected Systems Extensions > Microsoft Office 365 and set option Connect to Skype Online service to Yes, Save changes.

The new extension file has version 8.1.0.1, to check this you can open the Cayosoft Administrator console and go to the Home > Configuration > Connected Systems Extensions > Microsoft Office 365.

Known Issues

This is a list of known issues related to the patch:

1. Prerequisites Check Tool isn't patched and in v8.1.0 still check the presence of Skype for Business PowerShell module instead of Teams module.

2. Prerequisites Check Tool doesn't check if .NET Framework 4.7 is installed.

3. Error can appear when running rules or web actions that are using the Teams module: "Cannot validate argument on parameter 'Session'. The argument is null or empty. Provide an argument that is not null or empty, and then try the command again."