# Protected: Migrate Windows devices to Hexnode UEM with Hexnode Gateway

Hexnode Gateway enables migration of devices previously enrolled in a different MDM solution to Hexnode UEM without the need for the device to be wiped. This document elaborates the steps involved in the migration of a Windows device completely or partially managed by a different MDM solution to Hexnode.

Migrate Windows to Hexnode UEM
------------------------------

The Hexnode Gateway app for Windows helps migrate it to Hexnode from a different MDM. The following are the steps to create the required configuration file on the Hexnode UEM portal.

1. Navigate to **Enroll > All Enrollments > Migration > Windows**.
2. Click on **Generate a New Configuration File**.
3. Provide a suitable name for the configuration file.
4. Under Choose enrollment type, select one of the following management modes based on your requirements: 
    1. **Fully managed** – Provides complete administrative control over the Windows device through Hexnode UEM.
    2. **Co-managed** – Allows the device to be managed concurrently by Hexnode UEM and your existing management solution.
5. Admins can choose to migrate their managed Windows devices using either of the options **Migrate with Gateway UI** or **Migrate silently**. 
    1. **Migrate with Gateway UI**– It is the default method. The following options are accessible on the Hexnode Gateway application only when **Migrate with Gateway UI** is enabled: 
        - ***Enforce Hexnode Gateway app in full screen***
        - ***Allow user to exit full screen*** (Available only when *Enforce Hexnode Gateway app in full screen* option is enabled)
    2. **Migrate silently**– The device is migrated to Hexnode without any user intervention.
### Configure network settings

7. **Wi-Fi settings**– Enable the option **Add Wi-Fi settings to configuration file** to configure the [Wi-Fi settings](https://www.hexnode.com/mobile-device-management/help/wifi-configuration-on-windows-devices-with-mdm/%22).
8. **VPN settings**– Enable the option **Add VPN settings to configuration file** to configure the [VPN settings](https://www.hexnode.com/mobile-device-management/help/how-to-configure-vpn-settings-on-your-windows-devices/).
### Configure device settings

10. Configure the **Enrolled device name** by giving a suitable name. This field accepts [wildcards](https://www.hexnode.com/mobile-device-management/help/how-to-pass-device-and-user-information-using-the-wildcards-supported-by-hexnode-mdm/).
11. Add the device to a device group by choosing one from the available dropdown under **Add to device group** and clicking on **Add**.
12. Add the device to an organizational unit by choosing one from the available dropdown under **Add to Organizational Unit**.
13. Check **Escrow BitLocker recovery key** to retrieve the recovery password from the device and store it on the Hexnode UEM portal. The retrieved recovery password can be viewed under **Manage > Device Summary > Hardware Info** once the migration is complete.
14. Click on **Generate a custom MSI file** to generate the configuration file in downloadable format.
15. Download the MSI file onto your device.
16. Deploy the configuration file to target Windows devices using your existing MDM.

### Complete device migration

Once the MSI file is deployed on the device, the Hexnode Gateway app opens up. Depending on the existing enrollment status of the device, follow the suitable steps.

#### Case 1: The device is enrolled via Autopilot

1. Reassign the device in the Azure portal to an MDM server associated with this Hexnode UEM console.
2. A pop-up message requesting the user to enroll the device with Hexnode UEM arises on the device end if **Migrate with Hexnode UI** is enabled. Click on **Open Hexnode Gateway**.
3. Now, click **Migrate to Hexnode UEM** in the Hexnode Gateway app to disenroll the device from the existing MDM and initiate enrollment.

#### Case 2: The device is enrolled but not via Autopilot

1. A pop-up message requesting the user to enroll the device with Hexnode UEM arises on the device end if **Migrate with Hexnode UI** is enabled. Click on **Open Hexnode Gateway**.
2. Click **Migrate to Hexnode UEM** in the Hexnode Gateway app to disenroll the device from the existing MDM and initiate enrollment.

#### Case 3: The device is not enrolled

1. Click on **Enroll to Hexnode UEM** in the Hexnode Gateway app to enroll the device.

Once the status bar loads and the enrollment with Hexnode is complete, the Hexnode Gateway app will be uninstalled from the device.