Chatta subito con l'assistenza
Chat con il supporto

On Demand Migration Current - Desktop Update Agent Release Notes

Release Notes

On Demand Migration Desktop Update Agent (DUA) Version 1.2.1

Release Notes

April 2022

These release notes provide information about the On Demand Migration Desktop Update Agent release.



About this release

To complete a migration project and reconfigure a user's applications, agents must be configured and deployed by administrators, then run on users' workstations or by user using the direct download link.

Desktop Update Agent provides the following agent deployment capabilities:

  • Ability to manage users' application reconfiguration activities from a single view within On Demand Migration. Migration administrators can configure which applications will be reconfigured, track each application’s status, and send notices to remind users if required.
  • Two deployment options to install the agent to the user’s workstation.
  • Support for OneDrive for Business and Microsoft Teams.
  • Support for Microsoft 365 Apps license reset.
  • Support for various client authentication mechanisms.
  • Support for Outlook Profile reconfiguration.

Minimum 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.
  • The permission to download and run an executable file. (optional)
  • 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 or Office are not installed on the workstation, those applications will be skipped and not impact any other applications present during the reconfiguration.

NOTE: Outlook is required on the workstation, as part of the current agent management process.

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 (Most recent updates recommended)
  • Windows 7 (32-bit or 64-bit) or Windows 10 (32-bit or 64-bit), or Windows 11
  • .NET 4.0.x or higher (4.6.x or higher recommended)
  • Microsoft 365 Apps (Office Click-to-Run Version Only)

NOTE: Microsoft Office Professional Plus is not supported for Office license reset.

Network Requirements

The minimum network requirements to run Desktop Update Agent:

  • Internet access using port 443.
  • Internet access to download the executable (optional).
  • Internet access to connect to Microsoft 365.
  • Internet access to On Demand Migration Endpoints. (NOTE: Proxies or security applications that intervene in network access may prevent the agent from connecting to On Demand Migration. Check the agent logs for details if this occurs.)
    • Internet access to Exchange Online "Autodiscover" endpoints at:

      • Global:

        Optionally, you can use the equivalent ‘.us’ Government Community Cloud (GCC) endpoints, when applicable.

      • China:

      • Germany: (deprecated)

    • Local access to read\write the following registry keys on the end-user's workstation:
      • Outlook 2010: HKEY_CURRENT_USER\Software\Microsoft\Windows NT\CurrentVersion\Windows Messaging Subsystem

      • Outlook 2013: HKEY_CURRENT_USER\Software\Microsoft\Office\15.0

      • Outlook 2016: HKEY_CURRENT_USER\Software\Microsoft\Office\16.0

      • Outlook 32-bit: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Office

      • Outlook 64-bit: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office

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


The following is a list of enhancements implemented in On Demand Migration Desktop Update Agent.


Table 1: Enhancements in version 1.2.0

General improvements Issue ID
Ability to retain OneDrive file locations when reconfiguring a OneDrive application. 253355
Windows 11 support. 312718


Table 2: Enhancements in version

General improvements Issue ID
An information message is displayed if DUA times out waiting for the Microsoft OneDrive Set up wizard to complete. 318446


Table 3: Enhancements in version

General improvements Issue ID
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


Table 4: Enhancements in version

Enhancements Issue ID
Logging improvements  

A single unified log file is created for each run with a name based on the workstation name and time of the session. By default, a less verbose log is generated.

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

Resolved Issues

The following is a list of issues addressed in this release.


Table 5: Resolved issues in version 1.2.1

Resolved Issue Issue ID

When DUA performs the Outlook reconfiguration task, Outlook will not be restarted immediately. It will be restarted after the agent has performed all of the required tasks.

If Outlook is running when DUA starts the OneDrive reconfiguration task, users are prompted to close Outlook before proceeding. This avoids Outlook potentially using files from OneDrive and blocking the local folder rename action.



Table 6: Resolved issues in version 1.2.0

Resolved Issue Issue ID
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


Table 7: Resolved issues in version

Resolved Issue Issue ID
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


Table 8: Resolved issues in version

Resolved Issue Issue ID
Issue when multiple profiles are available and a user selects a profile other than the first in the list. 316641


Table 9: Resolved issues in version

Resolved Issue Issue ID
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
Strumenti self-service
Knowledge Base
Notifiche e avvisi
Supporto prodotti
Download di software
Documentazione tecnica
Forum utente
Esercitazioni video
Feed RSS
Richiedi assistenza sulle licenze
Supporto tecnico
Visualizza tutto
Related Documents

The document was helpful.

Seleziona valutazione

I easily found the information I needed.

Seleziona valutazione