Migrate Surface Hub 2S to Microsoft Teams Rooms on Windows

If you have a Surface Hub 2S, you can migrate it to run the Microsoft Teams Rooms on Windows experience. This enables Surface Hub 2S devices to run the same Windows 11 software platform shipping on new Surface Hub 3 devices.

Background

Begin the migration process via the downloadable Surface Hub 2S OS Migration Launcher - Microsoft Teams Rooms app, which you can install directly on a Surface Hub 2S or remotely via Microsoft Intune or other cloud management tools.

Migration Launcher app deletes OS and data

Use of the Migration Launcher app on Surface Hub 2S involves significant changes to the operating system and stored data. Here are key points to understand before proceeding with the migration process:

• Removes the Windows 10 Team edition OS: Migration completely eliminates the Windows 10 Team edition operating system preinstalled on the Surface Hub 2S.
• Requires consent for data and configuration removal: By installing and initiating the Migration Launcher app on a Surface Hub 2S, you agree to the complete removal of the Windows 10 Team edition OS. This process includes uninstalling and erasing all accounts, data, and existing configurations.
• Excludes first-generation Surface Hubs: The Microsoft Teams Rooms on Windows experience and the Migration Launcher app don't support or affect first-generation Surface Hubs (Surface Hub v1).
• Requires significant download and storage space: The migration process necessitates downloading approximately 30 GB of data and needs sufficient on-system storage to establish a temporary partition.
• Increases energy consumption: Switching to the Microsoft Teams Rooms on Windows experience leads to higher energy usage due to adjustments in sleep state and power management settings.

Prerequisites

• Ensure Surface Hub 2S is connected to the Internet and has the latest Windows Updates, including Microsoft Corporation - System Hardware Update - 2/8/2024.

• To get all the required updates, sign in with Admin credentials, go to All apps > Settings > Update and Security > Windows Update, and install all updates.

• Repeat the update retrieval process until you install all the available updates.

• Once updated, confirm that the UEFI version is 699.845.768.0 or later.

• If you're unable to check for Windows updates locally (for example, in remote admin scenarios), you can verify the OS version via Microsoft Intune admin center or other mobile device management (MDM) solutions.

• You can also check by validating that Windows 10 OS Build 19045.4123 or later is present on the system.

• Validate that your network can handle a 30 GB download.

• Ensure the network you're using doesn't have any other firewalls, blockages, or limitations that would otherwise prevent the download and installation of software onto the Surface Hub 2S devices you intend to migrate.

• Confirm IT allows network access to required sites: *.devices.microsoft.com and download.microsoft.com. On a separate PC, open a command prompt and enter the following commands:

  ping devices.microsoft.com
  

  ping download.microsoft.com
  

Surface Hub 3 Compute Cartridge option

Optional: Streamline post-migration deployment with Windows Autopilot and Teams Rooms Autologin

Whether you initiate the migration process manually on a Surface Hub 2S or remotely via Intune, it's advantageous to set the stage for the device to autonomously complete its deployment post-migration, utilizing Windows Autopilot in conjunction with Autologin of Teams Rooms. This approach is beneficial for customers triggering migration remotely, as it facilitates a fully remote, end-to-end process spanning migration to the Teams Rooms on Windows experience to the subsequent deployment within your organization.

For detailed guidance on enrolling your Surface Hub in Autopilot and Autologin of Teams Rooms, see Deploy Surface Hub with Windows Autopilot & Autologin of Teams Rooms.

Install Migration Launcher app to trigger a migration

Choose one of the following options:

• Manually install Migration Launcher app on Surface Hub 2S. Designed for migrating individual Surface Hub 2S devices.
• Remotely install Migration Launcher app via Intune. Designed for migrating multiple select Surface Hub 2S devices remotely.

Manually install Migration Launcher app on Surface Hub 2S

1. Sign back in as admin. Go to Surface Hub > Apps & features > Open Store.

2. Search for Surface Hub 2S OS Migration Launcher – Microsoft Teams Rooms and select Get.

   

3. To validate successful installation, select All apps and look for Surface Hub 2S OS Migration Launcher.

4. Once you see the Migration Launcher in the app list, the migration proceeds automatically upon restarting the Windows 10 Team edition OS. You can either manually restart Surface Hub 2S or wait until the system automatically restarts during the default nightly maintenance window.

   Tip

   After this initial restart, do not interfere with the system; even though it may appear nothing is happening and you still see the same experience, the migration proceeds independently after completing all necessary backend processes (including downloading and unzipping the new Teams Rooms on Windows image).

5. Typical migration time is around 90 minutes from restart after installing the Migration Launcher app, but the length can vary depending on many characteristics, including customer network bandwidth and related factors.

6. When migration is complete, the device displays the Windows first-time setup program, also known as Out of the Box Experience (OOBE). To learn more, see First-time setup for Surface Hub running Microsoft Teams Rooms on Windows.

Remotely install Migration Launcher app via Intune

Summary

1. Ensure your Surface Hub 2S devices are fully updated and enrolled in Intune.
2. Add Surface Hub 2S devices to a Device group.
3. Download Migration Launcher app via the WinGet command line tool.
4. Deploy Migration Launcher app via Intune.

Ensure your Surface Hub 2S devices are fully updated and enrolled in Intune

• To verify enrollment, sign into Intune admin center, go to Devices > All devices, and look for the names of your target devices.

• Check that the OS version for the target devices meets the prerequisites listed earlier, specifically OS version 19045.4123 or later.

  

Add Surface Hub 2S devices to a Device group

1. Sign in to the Microsoft Intune admin center.

2. Select Groups and then select New group.

3. In the Group type field, choose Security.

4. Enter a Group name and Group description for the new group.

5. In the Membership type field, choose Assigned.

6. Select Create to create the new group.

7. Open the Group, select Members > Add members and add the Surface Hub 2S devices you're targeting for migration.

   

Download Migration Launcher app via WinGet

Install and use WinGet on a second device

1. By default, WinGet is preinstalled on Windows 10 (version 1809 and later) and Windows 11. To confirm you have WinGet installed on your separate PC, open a PowerShell command prompt and enter winget.

2. Ensure you're running WinGet 1.8 or later.

3. If WinGet is not present or you need the latest version, follow these instructions: Install WinGet.

4. Enter the following command to download the Migration Launcher app:

   winget download 9P81T95QGN1P --platform windows.universal -a x64 --skip-license
   

5. Agree to the terms, as shown in the following figure.

   

6. View the downloaded files in a newly created subdirectory your Downloads folder:

   

WinGet command parameters

• 9P81T95QGN1P: The Microsoft Store app ID for the Migration Launcher app package.
• platform windows.universal: Refers to the Universal Windows Platform (UWP), which means the package is designed to run on multiple Windows devices, including Surface Hub, PCs, tablets, and other devices that support UWP.
• -a x64: Specifies the architecture of the package, compatible with 64-bit Windows systems.
• --skip-license: Bypasses the requirement to accept the license agreement before downloading the package. By using this flag, you are automatically accepting the license terms without being prompted during the download process.

Deploy Migration Launcher app via Intune

1. Sign in to Intune Admin Center and go to Apps > All apps > Add. Under App type, select Line-of-business app.

   

2. Configure app information on the Add App page. Under the App information section, choose Select app package file. In the flyout pane, select the blue folder icon under the App package file and navigate to select and upload your LOB app package, in this case, the Surface Hub 2S OS Migration Launcher – Microsoft Teams Rooms MSIXBUNDLE file downloaded in the earlier section: Microsoft.SurfaceHUBMTROSTriggerApp_1.48.137.0_neutral_~_8wekyb3d8bbwe.msixbundle.

3. Select Dependency app files and choose the blue folder icon to select and upload all dependencies, located in the Dependencies folder that was downloaded via WinGet. The inventory of required files displays a green check box to indicate that you have all the required files uploaded.

   

   Tip

   You only need to ensure the three check box icons appear for your specified architecture

4. Select OK after you add all the necessary files.

5. Under App information, select Next.

Assign app

Under the Assignments tab, specify how the app is deployed to your Surface Hub 2S devices. You can make the app available for enrolled devices or assign it as required.

1. Under Required > Group mode, select Add group and add your intended Device group.

2. Under Required Group mode > Install Context, select User context link, and in the flyout pane, change the App settings toggle to ensure Device context is selected and then select OK.

   

3. Select Next.

Review and create

• Under Review + create, review all settings and configurations. Select Create to deploy the app.

  

This might take a few minutes, depending on network connectivity or other factors. You can check the upload status under the Notifications tray.

Monitor deployment of Migration Launcher app

• After deploying the Migration Launcher app, monitor its deployment status in Intune.

• To see the status of the deployment, navigate to the app in Intune and check the Overview and Assignments tabs. Check the Device context status, not the User.

  Note

  Several factors contribute to how long it takes for the app to finish deployment and installation on the target devices, including device power/sleep state, sync cadence/status with Intune, and related factors. Continue to monitor Intune status for indications of successful app deployment.

• Once the app is deployed, the next restart initiates migration, which - in this remote deployment scenario - is likely to be the automatic restart as part of the nightly maintenance window. Similar to the manual app deployment scenario, the migration process typically takes about 90 minutes after this restart (but many factors can impact migration time, as explained earlier, with a test example exceeding 5 hours on a slower network). Customers should test and validate sequences based on their unique infrastructure and management approaches.

• When migration is complete, the device displays the Windows first-time setup program, also known as Out of the Box Experience (OOBE). To learn more, see First-time setup for Surface Hub running Microsoft Teams Rooms on Windows.

Manual removal of migrated Surface Hub devices from Teams Admin Center (Surface Hubs Legacy tab)

After migrating your Surface Hub 2S to the Microsoft Teams Rooms on Windows platform, you need to manually remove the device listing from the "Surface Hubs (Legacy)" section of Teams Admin Center. This will thereafter enable the device to show up properly under the "Teams Rooms on Windows" section and enable accurate device management.

1. Navigate to Teams Admin Center:
   • Open your web browser and go to the Teams Admin Center.
   • Sign in with your admin credentials.
2. Access the Surface Hubs (Legacy) Tab:
   • In the Teams Admin Center, select Teams devices > Surface Hubs (Legacy).
3. Manually remove the migrated device:
   • Locate the row corresponding to the migrated Surface Hub device and select the device.
   • Select Remove to manually remove the device's row from the list.
4. Verification:
   • Refresh the page or navigate away and then back to the Surface Hubs (Legacy) tab to ensure that the device has been successfully removed.
   • Verify that the migrated device is now correctly managed under the appropriate tab for Teams Rooms devices, if applicable. This may take up to 12 hours to happen, but will happen automatically.

Manual cleanup of stale Intune device objects for migrated Surface Hub devices

If you registered a Surface Hub 2S with Intune before transitioning it to the Microsoft Teams Rooms on Windows platform, you might encounter a "stale" device record. This situation occurs when the original device object in Intune remains unchanged, even after a new record is created for the Teams Rooms platform.

Although this stale record doesn't interfere with Intune-based management of the migrated Surface Hub device, we recommend removal of these outdated entries to maintain directory cleanliness.

1. Access Microsoft Intune Admin Center: Sign in with your admin credentials.

2. Navigate to Devices: Use the left-hand navigation pane and select the Devices tab.

3. Locate All Devices: Within the Overview section, select All devices to view the entire list of managed devices.

4. Identify and select the stale device object: Look for the device object that needs removal. You can identify the stale entry based on your established device naming conventions. Typically, the stale record displays an OS build number of 19045, indicative of the Windows 10 Team edition, as opposed to the updated OS build number 22621, which signifies the Windows 11 IoT Enterprise version 22H2, post-migration.

   Note

   Pay close attention to the OS build numbers to accurately distinguish between pre-migration and post-migration device records.

5. Delete the stale record: On the selected device object’s page, navigate to the top menu and select Delete to remove the stale device record from Intune.

Post-migration configuration

Review the following articles for recommended next steps:

• Get started with Surface Hub running Microsoft Teams Rooms on Windows
• First-time setup for Surface Hub running Microsoft Teams Rooms on Windows
• Security best practices for Surface Hubs running Microsoft Teams Rooms on Windows
• Install wallpaper on Surface Hub running Microsoft Teams Rooms on Windows

Troubleshooting

Quick checks

• Verify that Surface Hub 2S is fully updated and otherwise meets the prerequisites described earlier. To learn more, see Troubleshoot Surface Hub not Updating
• Ensure the Migration Launcher app is installed on target Surface Hub 2S devices.
• Ensure the system restarts after installing the Migration Launcher app.

Event logs

• If migration doesn't proceed after 24 hours, check system event logs for possible errors, including a potential issue related to available storage space.

• To open Event logs, on Surface Hub go to Settings > Update & security > Logs > Event Viewer. Event logs are located under Windows Logs > System.

• You can filter for the following Event IDs, as shown in the following figure: 6,7,8,9,10,11. Select the System log > Filter Current Log:

  

Monitoring Surface Hub migration events

When overseeing the migration process on Surface Hub 2S, pay attention to specific events logged by the SurfaceHubMonitor source. Event IDs 6-11 indicate different stages and potential failures in the migration process.

Key Event IDs

Error during migration

If you encountered a WinPE invalid path error (directing you to this page) during the migration process, you will need to follow the instructions for manual recovery to complete the migration to the Microsoft Teams Rooms on Windows platform. At that point in the process your Hub 2S is ready to be re-imaged with the Windows 11 IoT Enterprise with the Microsoft Teams Rooms on Windows experience recovery image as described in the Recovery from a USB drive steps.

Best practices for a smooth migration

Avoid Frequent Reboots: It's important not to reboot the system unnecessarily during the migration process. Frequent reboots can restart the download process, extending the migration duration and causing it to seem like "nothing is happening." By monitoring these specific events, you can effectively track and troubleshoot the migration process of your Surface Hub 2S.

Remote deployment via Intune

• If the Migration Launcher app fails to deploy, check any error messages in the Intune console.
• Verify that the Surface Hub 2S devices are correctly enrolled and online.