Chat now with support
Chat with Support

Client Profile Updating Utility 5.9 - Administration Guide

Rolling Back Changes

The changes made by CPUU in the Microsoft Outlook profiles can be rolled back if any issues occurr during the update. You will likely need to undo changes made in one or several selected profiles. Unless you want to roll back changes made in all mailboxes’ profiles, do not start the Client Profile Updating Utility from the logon script. Instead, copy the ClientProfileUpdatingUtility.exe file and a batch file to a user’s workstation and start the utility manually from that workstation.

To undo the changes made by the Client Profile Updating Utility, run the CPUU_Rollback.bat file that was created by the Client Profile Updating Utility Configuration wizard.

Caution: No rollback is possible if the Cleanup operation has been performed. For more information about Cleanup mode, refer to the Modes topic.

Technical Reference

This section covers technical reference information about Client Profile Updating Utility, as follows:

CPUU Parameters

Entering or reviewing command-line parameters is usually not necessary. The Client Profile Updating Utility Configuration wizard creates configuration files (CPUU.ini and CPUU_Update.bat) with the appropriate parameters for you.

You need to reference this section only in the following cases:

  • You read about a parameter in the Client Profile Updating Utility Configuration wizard online help and want more information.
  • You want to create the command line by yourself (though this is not recommended) and run the Client Profile Utility from the command line rather than using the configuration files generated by the Client Profile Updating Utility Configuration wizard.

Management Parameters

The following management parameters are used in CPUU_Update.bat:

Parameter Description
-Profiles <ProfileName1> [ProfileName2] [ProfileName3] [...]

Makes the Client Profile Updating Utility process the specified profiles only.

NOTE: If two versions of Outlook are installed side-by-side on the computer, CPUU processes profile from the newer version of Outlook.

-Undo <ProfileName1> [ProfileName2] [ProfileName3] [...] Rolls back changes made to the specified profiles. Specify the names of the profiles you want to undo the changes in. If the utility is run with this parameter from a logon script, the changes will be rolled back on every workstation.
-UndoAll Rolls back all changes made by the utility to all updated profiles. If the utility is run with this parameter from a logon script, the changes will be rolled back on every workstation.
-DefaultProfile Default profiles can be updated with the -DefaultProfile parameter, without the need to look up the profile name.
-LeaveTemporaryProfile Before updating a profile, CPUU checks that the target mailbox is available and accessible with current CPUU.ini settings by creating the temporary target profile and trying to logon to it. By default, the temporary profile will be deleted after that. If -LeaveTemporaryProfile is specified, temporary profile will remain. Temporary profile name is like the following: CPUU_{<random GUID value>}. -LeaveTemporaryProfile is useful if CPUU cannot access the target mailbox with current CPUU.ini settings. In this case, you can leave the temporary target profile, open it in the Mail Control Panel applet and check which of the profile settings are incorrect and determine what should be changed in CPUU.ini to force CPUU to set the correct settings for a target profile.
-UndoDefaultProfile Default profiles can be rolled back with the -UndoDefaultProfile parameter, without the need to look up the profile name.
-Log <LogFile>

Specifies the name and path to the log file. You can specify either the full path to the log file or only the file name, in which case the log will be written to the folder from which the utility is started. If this parameter is not specified, the log file will be created with the default name, CPUU.log.

You can use the following additional parameters to add the client computer name and the current date and time:

#H – inserts client computer name

#D – inserts the current date

#T – inserts the current time

You can also use the existing environment variable values to form the CPUU log file name. For example, you can add the user name of the account currently logged on to the name of the log file by typing the following expression:

%username%_CPUU.log

The %username% parameter will be replaced with the real user name associated with the security context in which CPUU was started.

NOTE: If CPUU log files reside in a remote location, CPUU first writes all .log, .csv and crash dump files into the CPUULogs folder in the TEMP directory on the local computer and after CPUU completes its operations, the .log and .csv files are moved to the remote folder. Crash dump files are not moved by default. The maximum number of dump files in the CPUULogs folder is limited to 10.

-MoveDumpsToRemote Enables moving of crash dump files to the CPUU log folder if this folder is located on the remote computer.
-MaxLocalDumps Specifies the maximum number of dump files to be stored in the %TEMP%\CPUULogs folder on a local computer. The default value is 10.
-LogWriteDirectly CPUU writes all .log, .csv and crash dump files directly to the CPUU log folder if this folder is remote.
-Cleanup Deletes all backup profiles and cleans up all auxiliary backup information. Please make sure that all profiles have been successfully updated and no rollback is required before running the utility with this parameter.
-INI <FileName> Specifies the path to the INI file. By default, the file resides in the same directory as CPUU_Update.bat.
-DoNotModifyExcludeSCPLookup

By default, CPUU disables Autodiscover SCP lookup when processing Outlook profiles. To turn off that behavior specify this parameter. In particular, it should be always specified when processing Outlook 2016 profile for a mailbox migrated using On Demand Migration for Email.

NOTE:This parameter is effective only in case the URLs of the Autodiscover service for source and for target are not specified on the Autodiscover step of the Client Profile Updating Utility Configuration wizard.

-NameTrgStoreAsSrc This parameter configures CPUU to preserve a source store display name after switching profile to a target mailbox. It is useful in migrations from one Office 365 tenant to another using ODME in which target store by default has the .onmicrosoft.com domain suffix and you plan to change it to the source name after all mailboxes from the source tenant are migrated to the target tenant and then switched.
-SkipAutodiscoverChecking By default, CPUU checks that an Autodiscover URL is on a source domain and a target autodiscover URL is on a target domain. To turn off that behavior specify this parameter for Microsoft Outlook 2016/2019 in case RecreateSwitchMsg is set to 1 in SwitchResMB configuration file.
CPUU cannot update the profile in case Outlook Profile and Switch Message do not contain valid information about source Autodiscover URL and target Autodiscover URL.
-? Displays help information.
-DisableLogonThroughOutlook Bypass startup of Outlook to prompt for target user credentials during first access to the target mailbox and to perform authentication.
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating