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
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.4.1
December 2024
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 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. |
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. |
|
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 |
Previous Deployment
Desktop Update Agent version 2.4.0
August 2024
Support for reconfiguring "New Outlook". |
483557 |
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 |
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
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 |
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
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 |
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
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 |
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
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 |
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
Ability to refresh accounts before running the switch task. |
438878 |
June 2023
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 |
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
Problems when Windows Known Folders Move is used to redirect user folders to OneDrive. |
419154 |
April 2023
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
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 |
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
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
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 |
Desktop Update Agent version 2.0
Previous versions of Desktop Update Agent relied on hidden message stored in the source mailbox on Outlook to retrieve application reconfiguration details from On Demand Migration.
The current implementation removes this limitation by allowing users to reconfigure their application using their target Microsoft 365 tenant account if the agent cannot access the source mailbox through Outlook. |
322542 |
|
369021 |
When running DUA for more than one user on the same workstation, the Microsoft 365 application license reset step may fail with an Access Denied error in the DUA logs. This is caused by a temporary file, output.txt, that is left behind in the directory C:\ProgramData\Quest\DUA\WPJCleanUp. This fix gives the file a unique name, and removes it after processing, unless some other error is encountered during the license cleanup step. |
370854 |
|
362409 |
Update RestSharp to 106.15.0. |
350956 |
After switching Outlook and running DUA with Source Profile selected, the Outlook status may display as 'not started' instead of 'reconfiguration completed'. |
358570 |
|
360998 |
Ability to retain OneDrive file locations when reconfiguring a OneDrive application. |
253355 |
Windows 11 support. |
312718 |
Agent sending unexpected status "Configured for different user" to On Demand Migration. |
324563 |
Microsoft Teams failed to switch due to hooks.json issue. |
324564 |
French localization issues. |
323528 |
Unexpected runtime exceptions reported in the exit stage of the supporting DUA agents. |
323735 |
.NET version updated to 4.7.2. |
324623 |
Issue when One Drive target email and UPN are different than the source. |
331372 |
Incorrect DUA version is displayed in the Windows Apps & Features list. |
321690 |
DUA version is not displayed in the About box. |
321656 |
DUA closes unexpectedly after successfully completing the Microsoft Outlook step in the migration project. |
321806 |
An information message is displayed if DUA times out waiting for the Microsoft OneDrive Set up wizard to complete. |
318446 |
An information message is displayed when no agent is found. This is to alert the user so that the agent does not exit silently. |
317410 |
Issue when multiple profiles are available and a user selects a profile other than the first in the list. |
316641 |
Logging improvements |
|
|
282268 |
Communication improvements |
|
On Demand Migration API calls now include automatic retry. This improves robustness in case of transient issues with internet connectivity. |
267172 |
TLS 1.2 support for improved connection security. |
285254 |
User Experience enhancements |
|
Agent localized for Simplified Chinese, German, French, and Japanese. |
269016 |
Various usability improvements. |
289479 |
Ability to close Outlook and/or Teams from within DUA. |
289478 |
Tasks reordered to resolve a Teams issue. |
275077 |
An exception related to timeout waiting for OneDrive credentials. |
277959 |
Unable to attach the PST file to Outlook after reconfiguration. |
302055 |
Issue with Teams moving to target when Outlook Profile is not processed. |
275077 |
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:
System requirements
Before you begin a migration project and agent deployment, ensure that your systems meet the following minimum requirements.
General Requirements
- Client has been licensed for On Demand Migration.
- Access to a Global Administrator account for each Microsoft 365 tenant.
- Disable policies that prevent Outlook Profile, OneDrive for Business, and Microsoft Teams application changes or creation.
- If applicable, users have been provided new or temporary password for the account in the new target destination Microsoft 365 tenant.
- Source and target users have matching attribute values to identify and pair objects together for mailbox and OneDrive content synchronization.
|
TIP: Try Password Sync for On Demand Migration Active Directory to keep your migrated hybrid users synchronized so when they are moved, they keep their existing password. |
License Requirements
Before starting a migration, each target user account must be licensed for each application that will be reconfigured using Desktop Update Agent. The following licenses are required:
- Exchange Online if configuring Outlook profiles.
- SharePoint Online if configuring OneDrive for Business application.
- Microsoft Teams if configuring Microsoft Teams application.
|
NOTE: On Demand Migration can automatically assign these licenses to target user accounts during the email and OneDrive migration process. |
Software Requirements
|
NOTE: If OneDrive for Business, Microsoft Teams, Outlook, or Office are not installed on the workstation, those applications will be skipped and not impact any other applications present during the reconfiguration. |
The minimum version requirements for software installed on user’s workstations:
- Outlook 2016 (32-bit or 64-bit) or higher
- OneDrive for Business (Most recent updates recommended)
- Microsoft Teams
- Windows 10 (32-bit or 64-bit) or Windows 11
- .NET 4.7.2 or higher
- Microsoft 365 Apps (Office Click-to-Run Version Only)
|
NOTE:
|
Network Requirements
The minimum network requirements to run Desktop Update Agent:
|
NOTE: During this process, the Outlook Profile will be copied to a new Profile directed to the target account. Due to this configuration, a new OST download will occur based on each user's current cache settings, if enabled. To avoid network congestion try disabling or curtailing the cache settings to a lower amount of data then slowly increase it as needed. This can be accomplished through policies. |
Supported Authentication
On Demand Migration Desktop Update Agent supports environments that use:
- Active Directory Federation Services (AD FS)
- Single Sign On (SSO) with mixed authentication modes, such as:
- Modern Authentication (ADAL)
- Forms Authentication
- Windows Integrated Authentication