OneDrive Helper 0.11.0: Folder Redirection to OneDrive backup, OneDrive problem alerts, self-service fixes

Three new features, all off by default. The folder move has been through one real migration so far, and the OneDrive problem alerts haven't yet seen a real sync error, so please pilot them on a few PCs first.

Moving users from Folder Redirection to OneDrive backup (FolderRedirectionMigration)

Moving a site off Folder Redirection used to mean, for every user: take them out of scope of the redirection GPO, gpupdate, re-point Desktop / Documents / Pictures back to C:\Users\<user> by hand, then turn on OneDrive's folder backup. OneDrive Helper now does the last two steps for you.

• When it's offered:
  • on a workstation (never on Remote Desktop, AVD, Citrix, Horizon or FSLogix hosts);
  • with folders still pointing outside the user's profile;
  • with no applied GPO containing Folder Redirection settings any more, read from gpresult the same way it lists "Applied Group Policy Objects";
  • and with a work account signed in to OneDrive.
• What the user gets: a card offering Move to OneDrive, approved by an administrator unless RequireAdminApproval is off. Then:
  • every redirected folder is pointed back to its normal place in the profile;
  • a Where are my files.txt note goes on the Desktop. Its wording is MigrationNoteText, and {folders} lists the old locations;
  • optionally, a Desktop shortcut such as Network Drive → U:\ or \\server\users\%USERNAME% (MigrationShortcutName / MigrationShortcutTarget);
  • Explorer and OneDrive restart, and OneDrive moves the folders in and backs them up.
• Files are not copied: the old files stay on the share for you to move across.
• The backup policy: while the feature is on, the service sets OneDrive's machine-wide KFMSilentOptIn policy (with KFMSilentOptInWithNotification).
  • The tenant comes from KFMTenantID, or from the signed-in work account if that's blank.
  • It never changes a value set by your own GPO or Intune.
  • Turning the feature off, or uninstalling, removes only what OneDrive Helper set.
• Events: 6101–6105.

OneDrive problems brought to the user's attention (OneDriveIssueAlerts)

Sign-in needed, sync errors and conflicts, sync paused or offline, and a OneDrive that's running but has stopped responding. Normally these only show as a mark on OneDrive's icon.

• Windows 11 and Server 2025: the alert shows OneDrive's own message, the same status File Explorer shows. Its button runs OneDrive's own command, such as Sign in or View sync issues, or offers Restart OneDrive if it's hung.
• Windows 10 and Server 2019/2022: the alert reports libraries that are not connected, have an error or are offline. Individual conflicts can't be detected there.
• Grace periods: errors and hangs are reported after about 2 minutes; paused, offline and not connected after IssueAlertGraceMinutes (default 30).
• Events: 6001–6004.

Self-service fixes (RequireAdminApproval)

On by default, so nothing changes. Turn it off to let users fix their own folders: their confirmation is enough, the button reads Fix instead of Fix (admin), and event 5001 records who confirmed. The file work runs as the user either way.

Also

• Settings window: now three columns, so it fits laptop screens with display scaling. The help line under it shows up to three lines, so long help texts are no longer cut off.
• OneDriveHelper.exe check shows OneDrive's reported status, the user's redirected folders, which redirection GPOs apply, the backup policy, the work account, and whether the move is offered (and if not, why). It warns when run from an elevated prompt, where OneDrive's status can be wrong.
• Fix journal: the fix's progress file is replaced safely when antivirus or the search indexer briefly holds the old copy. Before, that could stop a fix with "Access is denied".

Upgrading

Install over any earlier version as usual. The RMM install script in the README is updated for v0.11.0. The checksums are in SHA256SUMS.txt.