지금 지원 담당자와 채팅
지원 담당자와 채팅

On Demand Migration Current - Desktop Update Agent Release Notes

Deprecated features

The following features are no longer supported:

  • The On Demand Migration API used by the Desktop Update Agent version 1.x releases is no longer available. Desktop Update Agent version 1.x is no longer supported. The 1.x series agents are not able to communicate with On Demand Migration.

  • The “Direct Download” option is no longer supported.

Known issues

The following is a list of issues, including those attributed to third-party products, known to exist at the time of release.

Table 1: General known issues

Known Issue Issue ID

If a token is generated using a passphrase that contains a $ character, and if the passphrase is provided inside a double-quoted string, the DUA install will exit with an error message.
Workarounds:
1. Use single-quotes to contain the passphrase.

2. Use a passphrase that does not contain this special character.

2. Escape the $ character with a backtick character in front of it, e.g. for a passphrase abc$123 enter abc`$123

590336
PST file configuration in New Outlook is not migrated by DUA. Microsoft support for PSTs in New Outlook remains 'partial.' No API or alternative method is available to DUA to migrate PSTs during reconfiguration. Quest will continue to monitor the Microsoft 365 roadmap for further updates to PST support. 567073
If running On Demand Desktop Update Agent as Administrator, it is not possible to update OneDrive. This is a Microsoft OneDrive limitation. 498466
On Windows 10, if the Desktop Update Agent reconfiguration task for OneDrive is interrupted before the restart, after restart a message displays that a folder cannot be found. 529144

The OneDrive reconfiguration step drops all OneDrive connections on a computer when a restart is needed when switching one profile with the Preserve Existing Folder option enabled.

Accounts that were not switched will need to log in to OneDrive again. This affects computers with multiple user profiles.

407423
When migrating "roaming" signatures with Outlook O365, even though the registry keys get set, the signatures are not used by Outlook. 411635

If the Desktop Update Agent is stopped suddenly (for example, due to an unexpected computer restart or stopping the agent through Task Manager), On Demand Migration will not be updated with the in-flight results.

If progress in the agent is stopped between steps by choosing Cancel, the state of each step is reported to On Demand Migration and the On Demand Migration dashboard will reflect what was completed.

376672

DUA License reset is only supported for Azure Joined, Hybrid Azure Joined, or workplace joined, on Windows 10 1803 build and later.

268628
DUA will run office reset and clear saved credential cache with CD-Key version of the office installed. 267928

Release History

The following lists the new features, enhancements, and resolved issues by release.

Current Deployment

Desktop Update Agent version 2.5.2

October 2025

Resolved Issues Issue ID
Addressed a change in the behavior of OneDrive starting with build 25.179.0914.0003 where the Sign in to OneDrive dialog would have the Sign in button disabled (grayed out) when launched from DUA. 587364,
587007
Desktop Update Agent version 2.5.1 (Technical Preview)

September 2025

New Features Issue ID

The agent now runs silently in the background and automatically polls On Demand Migration for switch tasks at regular intervals. Users no longer need to manually start the agent; after installation it will automatically start on the next sign-in or reboot, and will open on the desktop to prompt for processing when action is required.

Processing can also be postponed by end users for several minutes or hours, providing greater flexibility.

NOTE: On the Switch Application Task's Schedule tab, the default option has changed from Run Now to Schedule.

Migration administrators should schedule Switch Applications tasks so that they are not run until prerequisite migration project steps have been completed and their help desk is ready to support users, if necessary.

Additionally, migration administrators can now view installed Desktop Update Agent reports directly in the On Demand Migration interface, improving visibility and management of agent deployments.

440407
A new OneDrive Application option on the Switch Applications task instructs the Desktop Update Agent to use the target UPN to reconfigure OneDrive. 440414
Resolved Issues Issue ID
Improved reliability of OneDrive migration when a restart is required to complete the process. All required data for the restart is saved immediately after a folder rename at restart is requested, preventing an inconsistent OneDrive state if the process is interrupted. 567031
DUA update - Installing when an agent is already present stops the On Demand Desktop Update Agent service, impacting OneDrive reconfiguration and App license reset features. 566232
Two Teams accounts displayed in the Teams Meeting Add-on. 533868

Previous Deployment

Desktop Update Agent version 2.4.2/2.4.3

September 2025

All resolved issues from the 2.4.2 hotfix and 2.4.3 release are also included in version 2.5.2.

Desktop Update Agent version 2.4.1

December 2024

Enhancement Issue ID
Selection of the Outlook variant (Classic or New) to reconfigure

Desktop Update Agent  needs to close and restart Outlook during the reconfiguration process, Which Outlook variants to reconfigure will be based on the following:

  • If New Outlook and/or Classic Outlook is configured and running when DUA starts, those Outlook variants will be stopped, reconfigured, then restarted.

    • If both variants are configured but only one is running when DUA starts, only the variant that is running will be reconfigured.

  • If neither New nor Classic Outlook is running when DUA starts, DUA will check the user's registry keys for the UseNewOutlook setting to determine which variant the user prefers. Classic Outlook or New Outlook will be reconfigured according to the value of that switch.

    • If the UseNewOutlook registry key is not present, DUA will check the computer for configured Outlook profiles (Classic) and reconfigure Classic Outlook if found.

      DUA will also check the computer for a user account for new Outlook, and reconfigure New Outlook if that account is found.

    • NOTE: Either Outlook variant must be started to complete reconfiguration. In this scenario it is possible that the Desktop Update Agent will start both Outlook variants.

  • If none of these conditions match, Outlook configuration will be skipped.

After the Desktop Update Agent completes, if the Outlook variant that was reconfigured is not the one expected or preferred by the user, a second run can be performed to correct this. The migration administrator can set up a new Switch task for any affected users. The user should ensure their required Outlook variant is running and then manually start the Desktop Update Agent. DUA will then reconfigure that Outlook variant based on the criteria listed above.

 
Resolved Issues Issue ID
Desktop Update Agent detects Outlook configured when the user is only set up for Teams. 521965
Desktop Update Agent does not open and show Outlook Completed when rerun after switching Outlook. 523925
Desktop Update Agent becomes unresponsive when new Outlook is updated from Classic Outlook using the 'Try the new Outlook' switch. 532054
Improved message displayed at the beginning of Desktop Update Agent reconfiguration Spanish edition. 523767
Message displayed at the beginning of Desktop Update Agent reconfiguration is in English in the Spanish edition. 521247
Outlook Reconfiguration - Unable to switch Outlook Classic if it is not running. 527977
Outlook Switch - When Desktop Update Agent is canceled before closing Outlook, the target profile is created but the status is not sent to On Demand Migration. 522344
When Classic and new Outlook co-exist only the Classic Outlook account is updated when Desktop Update Agent is run. 509138
When Teams is open during Desktop Update Agent reconfiguration, “Close Microsoft Teams now” does not reliably close Teams. 531207
Desktop Update Agent version 2.4.0

August 2024

New Feature Issue ID
Support for reconfiguring "New Outlook". 483557
Enhancement Issue ID
Addressed minor code quality issues identified by code analysis tools. 509214

Logging enhancements:

  • User interface enhanced to display agent log state when log requested.

  • "Error" relating to a PowerShell script changed to a"Warning" to better reflect the issue.

  • "PackageName" and "PublisherID" not displayed in the logs when searching for Installed Packages.

493210 501627 509031
Updates to support Microsoft libraries. 497711
Resolved Issues Issue ID
DUA does not recognize Teams as configured at the end of the Teams reconfiguration step and continues to wait. 519973
Office activation is a trial license when switching between Microsoft Outlook and Office. 492780

Localization issues (Spanish and German):

  • Some messages are not shown in correct language.

  • Link displayed for more information in an article of OneDrive in Windows Spanish edition opens the German edition.

  • "Next' button name updated to follow the instructions of the wizard in Spanish edition.

  • When the preconfiguration script has errors, the retry button “Reintentar” is not spelled correctly.

498306 498467 498860 501388
Desktop Update Agent version 2.3.1

May 2024

Enhancement Issue ID
Microsoft Entra ID (formerly Azure Active Directory) joined accounts can be reconfigured with the new Teams application. 488317
Microsoft.Identity.Client updated to the latest version. 489105
Resolved Issues Issue ID
Error when trying to switch Teams: Access is denied. 486189
No profiles after switching Outlook using the Remove Original Profile option. 485688
When Teams fails, the guidance is to "Press Retry to try again", but the dialog does not contain a Retry button. 486187
Unhandled exception is displayed when DUA is installed on a computer where Microsoft Office is not installed. 487570
Improve error message if the switch application task is configured to update Outlook on a computer that does not have Outlook installed. 490427
Desktop Update Agent version 2.3.0

March 2024

Enhancement Issue ID

Accessibility improvements:

  • Enabled keyboard (tab) navigation to the Options button ('cog' or 'gear' icon).

  • Provided accessibility text on the Options icon for screen reader to explain the purpose .

  • Fixed a navigation issue where the profile selection combobox would lose focus unexpectedly when changing selection.

  • Provided accessibility text on the profile selection combobox to explain the purpose.

471574
The Desktop Update Agent can now reconfigure the new Microsoft Teams application. 479017
Resolved Issues Issue ID
Corrected OneDrive setup issue where end user could be incorrectly prompted to choose a new OneDrive folder location during 'PreserveExisting' reconfiguration 460174
Error when Outlook profile is not found. 478671
Corrected minor localization issues. 472691
Desktop Update Agent version 2.2.2

January 2024

Enhancement Issue ID
The Desktop Update Agent now allows the underlying .NET Framework to choose the best TLS version available in Windows. TLS 1.3 will be used where it is available. 462429
The agent now logs the On Demand Migration endpoint that it will contact. This will help identify misconfigurations related to tokens and the different processing regions. 459448
Agent enhanced to support use of the Desktop Update Agent with On Demand Migration Hybrid Exchange. 464123
Resolved Issues Issue ID
If an incorrect passphrase is entered in the agent installer, a warning is issued and the installation will not complete. This avoids a situation where the agent would be installed, but no token would be stored. 446216
When switching multiple profiles on one computer, the status for the PowerShell Script steps could incorrectly reflect a previous run. The status now resets correctly for each profile. 449831

In some domain move scenarios involving a vanity domain, the Desktop Update Agent is unable to locate the source profile, because the source email and User Principal Name known to On Demand Migration will have changed as part of the move process.

In this situation, the Desktop Update Agent may try to create a new profile using another discovered email address, which may result in an incorrectly configured user profile. As a result, Outlook might not be able to start and will report that the current set of folders cannot be opened.

This change also resolves a OneDrive issue related to the same scenario.

464126
Added digital signatures to the Microsoft-derived scripts included with the Desktop Update Agent, which are used in the Office 365 application licensing step. 467724

 

Desktop Update Agent version 2.2.1

November 2023

Enhancement Issue ID
Ability to specify a domain to use for switch application tasks. This is necessary when the DNS domain is moving at the same time as the users but is not being set as the primary SMTP address in the target tenant. 460649

October 2023

Enhancement Issue ID
Desktop Update Agent can detect the new version of Microsoft Teams. At this time the agent cannot reconfigure the application. This update provides only detection and related messaging. (See Known issues.) 439471
Resolved Issues Issue ID
Handling of the PowerShell configuration scripts updated so that when errors occur, but are ignored within the PowerShell scripts, the agent will not report the script status as Failed. 455167

Agent fails to run the Outlook reconfiguration step where PST files are associated with the new profile.

445809
After an Outlook switch, the 'From' field in Outlook displays 'Microsoft Exchange' instead of the name of the sender. 443287

 

Desktop Update Agent version 2.2

August 2023

Enhancement Issue ID
Ability to refresh accounts before running the switch task. 438878

June 2023

Enhancement Issue ID
Ability to run custom PowerShell scripts before and/or after the desktop application reconfiguration. 248615
Added Spanish language localization. 402932
If Teams cannot be reconfigured because they are Microsft Entra ID-joined, users can choose to skip the Teams step of the migration process. 401374
  User interface redesigned to conform to On Demand Migration look and feel. 398170
Report agent version and FQDN to ODM when querying for reconfiguration task steps, to aid in tracking agent readiness and in troubleshooting. 417541
Resolved Issues Issue ID
Changed the method used to create the Outlook profile during the Outlook reconfiguration. This eliminates issues where a "Helper dialog" would appear and prompt for basic credentials. 418963
Improved troubleshooting information sent to ODM when reconfiguration steps fail, to speed up issue resolution. 412345
Agent can process Teams reconfiguration when multiple users are signed into Teams on the same computer. 423556
Suppress invalid file name characters from Target tenant name when renaming the OneDrive folder. 428845
Desktop Update Agent version 2.1

May 2023

Resolved Issues Issue ID
Problems when Windows Known Folders Move is used to redirect user folders to OneDrive. 419154

April 2023

Resolved Issues Issue ID
Added support for removing the source Profile and any associated files, if this option is chosen in the Switch Task. 274628
Changed Redemption libraries to version 5.27 to resolve sporadic credential dialog issues. 415849
If an installation exits because the mandatory Token/Passphrase parameters are missing, the user is presented with a usage guidance dialog. 417064
During a migration, the OneDrive step will clear the OneDrive identity cache. 411148

March 2023

Resolved Issues Issue ID
The Outlook Redemption library that is shipped with the agent has been updated to the latest version. 411364
Date added to the top of the log file. 413473

Corrected issues uninstalling and upgrading the agent when deploying with a GPO.

NOTE:

This version of the installer is designed for GPO deployment and does not have the
Token/PassPhrase options in the interface.

To manually install the agent, run MSIExec.exe in an elevated command or PowerShell
prompt and enter: msiexec /qb /i "ODM_DesktopUpdateAgent.msi" PASSPHRASE='Insert Passphrase Here' TOKEN="Insert Token Here"

413267
When Outlook, Teams, or On Demand Migration are not present an error message should not be displayed. This information is captured in the log file. 412894

February 2023

Enhancements Issue ID
Ability to continue the migration process even if the Outlook reconfiguration step fails. 394084
Resolved Issues Issue ID
Logging improvements to make more information available by default. 392122 393919 392123
The Outlook Redemption library that is shipped with the agent has been updated to the latest version to address Autodiscover connectivity . 393916
Fixed an issue affecting Outlook 2016 and 2019 where signatures would not transfer for some accounts. 410619

January 2023

Enhancements Issue ID
Ability to setup a DUA token expiration notification. 409479
Ability to setup a DUA token revoke notification. 410401

 

November 2022

Enhancements Issue ID

If the agent is unable to rename the OneDrive folder during the migration , OneDrive must be restarted. This will allow the folder to be renamed and the agent to process any remaining steps.

If needed, users are presented with the option to either restart OneDrive immediately or have the rename triggered on their next restart.

362169

 

Resolved Issues Issue ID
When parsing the list of Windows services in the registry, the agent expected a String value. Unexpected characters, such as wide characters (two bytes per character), would result in a System.InvalidCastException error and the agent closing unexpectedly. 392606
Optimization: When no eligible profiles are found, On Demand Migration requests will not be made. 385561
Fix that prevents the 32-bit agent from running unnecessarily on computers with 64-bit OS and Outlook. 386464
Uninstall will now remove the registry key that was created by the GPO deployment process. 384618

 

October 2022

Enhancement Issue ID

The migration state for OneDrive has been updated to display the OneDrive Migration State.

357162
The migration state for mailboxes has been updated to use mailbox status. 355930
Ability to skip the migration status validation during the configuration of the switch application task. 356643

Incident response management

Quest Operations and Quest Support have procedures in place to monitor the health of the system and ensure

any degradation of the service is promptly identified and resolved. On Demand relies on Azure and AWS

infrastructure and as such, is subject to the possible disruption of these services. You can view the following

status pages:

관련 문서

The document was helpful.

평가 결과 선택

I easily found the information I needed.

평가 결과 선택