OneDrive for Business file server migration breaks recent links for engineering files: Fix Guide

After migrating engineering files from a file server to OneDrive for Business, you notice that recent document links in CAD software, project management tools, or internal portals no longer open the files. These broken links typically point to the original UNC path on the file server, which no longer exists after the cutover. The root cause is that the migration changes the file location from a network share to a cloud-based path, but the software still references the old server address. This guide explains why the links break and provides step-by-step methods to repair them without losing file history or access.

Why Engineering File Links Break After a OneDrive Migration

Engineering software such as AutoCAD, SolidWorks, Altium Designer, and project management tools often store absolute file paths in their recent documents list, project files, or configuration databases. When you migrate files from a file server at \\fileserver\engineering\projects to a OneDrive folder at C:\Users\username\OneDrive - Contoso\Engineering\Projects, the software cannot find the old path. The link points to a location that no longer exists on the network.

The migration itself is not the problem. The problem is that the software does not automatically update its internal references. Engineering files are especially sensitive because they often contain cross-references to other files—for example, a CAD assembly file that links to multiple part files. If any of those part files have broken paths, the entire assembly fails to load.

The Role of UNC Paths and Drive Mappings

File servers use Universal Naming Convention paths like \\server\share\folder\file.dwg. After migration, these paths become invalid. If your engineering team uses mapped drives such as Z:\ pointing to the server, those mappings also stop working after the server is decommissioned. OneDrive uses a local folder structure that is not accessible via UNC unless you set up a symbolic link.

Steps to Fix Broken Links After OneDrive File Server Migration

There are three reliable methods to fix broken links. Choose the method that matches your environment and the number of affected files.

Method 1: Create a Directory Junction to Redirect the Old UNC Path

A directory junction acts as a redirect. When software tries to access \\fileserver\engineering, the junction points it to the OneDrive folder. This method does not require changing any file content or application settings.

1. Identify the old UNC path and the new OneDrive path
   Example old path: \\fileserver\engineering. Example new path: C:\Users\username\OneDrive - Contoso\Engineering. Write both down exactly.
2. Open Command Prompt as Administrator
   Press the Windows key, type cmd, right-click Command Prompt, and select Run as administrator.
3. Create the junction using mklink
   Type the following command and press Enter:
   mklink /J \\fileserver\engineering "C:\Users\username\OneDrive - Contoso\Engineering"
   Replace the paths with your actual old and new paths. The /J switch creates a directory junction.
4. Test the link
   Open File Explorer and type \\fileserver\engineering into the address bar. It should display the OneDrive folder contents.
5. Open the engineering software and check recent files
   Click a recent document link. The software should open the file from OneDrive through the junction.

Method 2: Batch-Update File References with PowerShell

If your engineering files contain internal cross-references—for example, a SolidWorks assembly that references part files—you need to update those references directly. PowerShell can replace the old server path with the new OneDrive path in text-based files.

1. Open PowerShell as Administrator
   Press the Windows key, type PowerShell, right-click Windows PowerShell, and select Run as administrator.
2. Run the Replace-String command
   Type the following command and press Enter:
   Get-ChildItem -Path "C:\Users\username\OneDrive - Contoso\Engineering" -Recurse -Include sldasm,sldprt,dwg,xml | ForEach-Object { (Get-Content $_.FullName) -replace '\\\\fileserver\\engineering', 'C:\Users\username\OneDrive - Contoso\Engineering' | Set-Content $_.FullName }
   Adjust the Include list to match your file types. The double backslashes in the -replace pattern are required for escaping.
3. Verify the changes
   Open a few files in the engineering software and confirm that cross-references resolve correctly.

Method 3: Remap Network Drives to OneDrive via Group Policy

If your team uses mapped drives, you can use Group Policy to remap the drive letter to the OneDrive folder. This method works for all users in an Active Directory domain.

1. Open Group Policy Management Console
   On a domain controller, open Group Policy Management from the Administrative Tools folder.
2. Edit or create a Group Policy Object
   Right-click the OU containing the engineering users and select Create a GPO in this domain. Name it OneDrive Drive Remap.
3. Navigate to Drive Maps preference
   Go to User Configuration > Preferences > Windows Settings > Drive Maps.
4. Create a new mapped drive
   Right-click Drive Maps, select New > Mapped Drive. Set Action to Update, Location to %USERPROFILE%\OneDrive - Contoso\Engineering, and check Reconnect. Set Drive Letter to Z:.
5. Run gpupdate on client computers
   On each engineering workstation, open Command Prompt and type gpupdate /force.

If Links Still Break After the Main Fix

OneDrive Files On-Demand Causes Missing Local Files

Files On-Demand can make files appear in File Explorer but not actually download them until opened. If the engineering software tries to open a file that is only a placeholder, the link may fail. To fix this, right-click the OneDrive folder or specific subfolder and select Always keep on this device. This forces all files to download locally.

Software Cache Still Points to Old Path

Some engineering applications cache recent file paths in a local database. For example, AutoCAD stores recent files in the Windows Registry at HKEY_CURRENT_USER\Software\Autodesk\AutoCAD\R24.0\ACAD-8001:409\Recent File List. You can delete the cached list or update the paths manually using Regedit. Always back up the registry before editing.

OneDrive Sync Client Throttles Large Engineering Files

Engineering files such as 3D models and point clouds can exceed 10 GB. OneDrive has a file size limit of 250 GB per file, but large files may cause the sync client to pause. If a file appears as synced but the software cannot open it, check the OneDrive activity center for sync errors. Pause and resume sync to force a recheck.

Directory Junction vs PowerShell Replace vs Group Policy Remap: Key Differences

Item	Directory Junction (mklink /J)	PowerShell Replace-String	Group Policy Drive Remap
Best for	Software that uses absolute UNC paths	Files with internal cross-references	Teams using mapped drive letters
Modifies file content	No	Yes	No
Requires admin rights	Yes	Yes	Yes (on domain controller)
Permanent fix	As long as junction exists	Permanent	As long as GPO applies
Risk of data loss	Low	Medium (always backup first)	Low

You can now repair broken links after migrating engineering files from a file server to OneDrive for Business. Start with the directory junction method because it requires no file changes. If cross-references inside CAD or design files still fail, use the PowerShell Replace-String method. For ongoing management, configure Files On-Demand to always keep your engineering project folders local. This prevents placeholder files from breaking software links in the future.