サポートと今すぐチャット
サポートとのチャット

Client Profile Updating Utility 5.8 - Administrator Guide

Updating Resource Mailboxes

Resource mailboxes are mailboxes that represent company resources you can book (such as conference rooms and equipment).

Since resource mailboxes are used only to book resources, normally no one logs on to them and therefore no Outlook profiles are created for them.

However, when migrating resource mailboxes, not all settings you configured in the source environment are migrated to the target by the agents. These settings can be updated by CPUU only after the mailbox is migrated. CPUU, however, requires Outlook profile to exist in order to update mailbox settings. If the number of resource mailboxes is large, it can be a challenge to create an Outlook profile for each resource mailbox manually.

The Switch Resource Mailboxes utility (SwitchResMb.exe) is a complementary utility to CPUU designed to help update resource mailboxes. With the help of SwitchResMb.exe you can update resource mailboxes in bulk without manually creating Outlook profiles. The SwitchResMB.exe utility creates temporary MAPI profiles for CPUU and then deletes them.

Caution: It is recommended to switch and process the resource mailboxes after the user mailboxes are already switched (that is, when the users log on to the target mailboxes).

TIP: In some cases Switch Resource Mailboxes can be also used for processing user mailboxes. For more information, see Processing User Mailboxes with SwitchResMB and CPUU in Dealing with Slow Connection while Updating Profiles.

System Requirements

SwitchResMb.exe is installed along with CPUU and located in the CPUU installation folder.

IMPORTANT: SwitchResMb utility does does not support profile processing in case of Office 365 tenant as a source.

The account used to run the utility must have permissions to log on to the source mailboxes that are being switched.

The following files are required for SwitchResMb.exe to run:

  • ClientProfileUpdatingUtility.exe – main CPUU executable file for 32-bit platforms.

Caution: The Switch Resource Mailboxes utility cannot run together with 64-bit editions of Microsoft Outlook, so it does not work with ClientProfileUpdatingUtility_x64.exe.

  • CPUU.ini– A file that contains configuration parameters for ClientProfileUpdatingUtility.exe.
  • DlgHookHandler.dll – DLL file that is installed by the CPUU setup.
  • A file that contains configuration parameters for SwitchResMb.exe and the list of resource mailboxes to be updated. This file must be created manually, as described in the Using the Utility topic.

Using the Utility

Before starting the Switch Resource Mailboxes utility, you should take the following steps:

  1. Create the configuration file according to your source and target environment. The format of the configuration file is described in SwitchResMB.ini Parameters

TIP: To create or change switch message for mailboxes perform the following:

In case Microsoft Outlook 2010 / 2013 and in case Microsoft Outlook 2016/2019 the section TargetMailboxesSMTP is empty or not specified, you need to create a new configuration file in the CPUU installation folder and to verify that the account specified by DCAccount parameter in the configuration file has permission to read source Active Directory information. To encrypt the password that this account use to connect to the source domain controller, run the following command line in the CPUU installation folder:

SwitchResMB.exe <configuration file name> <password for domain controller account>

The encrypted password will be saved to the DCPassword parameter of configuration file.

Caution: Password encryption is necessary in Microsoft Outlook environment and should be completed before starting the utility.

  1. Create a configuration file for Client Profile Updating Utility (CPUU.ini) in the CPUU installation folder. It is recommended to edit CPUU.ini as described in the Recommended Values for the CPUU.ini Parameters topic.
  2. Run the Switch Resource Mailboxes utility using the following command-line:

SwitchResMB.exe SwitchResMB.ini > PathToSwitchResMB.log

Parameters:

  • SwitchResMB.ini – the path to the configuration file
  • PathToSwitchResMB.log – The path to the log file that the utility will create. If this parameter is not specified, no log file will be created.

Only the configuration file parameter is required.

SwitchResMB.ini Parameters

The configuration file should contain the following sections and parameters:

Section [Settings]

This section is mandatory.

Parameter Details
CPUUCmdLine

Command line for ClientProfileUpdatingUtility.exe.

Required: Yes

Value: string (can be empty)

SrcExchServer

The source Exchange server name. The server name that is specified in Microsoft Outlook during a profile creation. Its format depends on source Exchange Server version:

  • Exchange 2010 or lower: FQDN format
  • Exchange 2013: Mailbox GUID, @ symbol, and the domain part of the user’s primary SMTP address (<Mailbox GUID>@<Domain Part>)

Required: Yes

Value: string (cannot be empty for Microsoft Outlook 2010/2013, but for Outlook 2016/2019 should be empty)

LogonNetworkSecurityNegotiate

Specifies whether source mailboxes use the Negotiate authentication method as a logon network security. The authentication method is specified in Microsoft Outlook during a profile creation.

Required: No

Value: 1 or 0

LogonNetworkSecurityWinnt

Specifies whether source mailboxes use the Password authentication (NTLM) method as a logon network security. The authentication method is specified in Microsoft Outlook during a profile creation.

Required: No

Value: 1 or 0

LogonNetworkSecurityAnonymous

Specifies whether source mailboxes use the Anonymous Authentication method as a logon network security. The authentication method is specified in Microsoft Outlook during a profile creation.

Required: No

Value: 1 or 0

LogonNetworkSecurityKerberos

Specifies whether source mailboxes use the Kerberos Password authentication method as a logon network security. The authentication method is specified in Microsoft Outlook during a profile creation.

Required: No

Value: 1 or 0

LogonNetworkSecuritySmartCard

Specifies whether source mailboxes use the Insert a smart card authentication method as a logon network security. The authentication method is specified in Microsoft Outlook during a profile creation.

Required: No

Value: 1 or 0

LeaveTemporaryProfiles

Specifies whether temporary MAPI profiles created by SwitchResMB utility for CPUU are deleted after processing. By default, the temporary profiles will be deleted after processing. If LeaveTemporaryProfiles is specified, temporary profiles will remain and can be used for troubleshooting purposes. Temporary profile name is like the following: {<random GUID value>}. To troubleshoot, open relevant temporary target profile in the Mail Control Panel applet, check profile settings to determine which prevent proper mailbox content updating, and change CPUU.ini or SwitchResMB.ini to avoid the issue.

Required: No

Value: 1 or 0

Section [AD]

This section is optional and can be used in case of switch message creating or changing to retrieve additional information.

Parameter Details
DCName

The source domain controller name.

Required: Yes

Value: String (cannot be empty)

DCAccount

The account used to connect to the source domain controller.

Required: Yes

Value: String (cannot be empty)

DCPassword The password used to connect to the source domain controller.

Required: Yes

Value: String (cannot be empty)

Section [RPCOverHTTP]

This section is mandatory in case of migration from Exchange 2013 or higher with Microsoft Outlook 2010 (earlier than 14.0.7159.5000, October 13, 2015, update for Outlook 2010 (KB3085604)), or with Microsoft Outlook 2013 (earlier than 15.0.4779.1001, December 8, 2015, update for Outlook 2013 (KB3114349))

.

Parameter Details
ConnectUsingHTTP

Specifies whether to use the RPC over HTTP setting for creation of source mailboxes.

Required: Yes

Value: 1 or 0

ProxyServer

Specifies source RPC proxy server which is specified in s in Microsoft Outlook during a profile creation.

Required: Yes

Value: String (cannot be empty)

PrincipalName

The principal name for proxy server which is specified in Exchange Proxy Settings in Microsoft Outlook during a profile creation.

Required: Yes

Value: String (can be empty)

SSLOnly

Specifies whether to use the Connect using SSL only option which is specified in Exchange Proxy Settings in Microsoft Outlook during a profile creation.

Required: Yes

Value: 1 or 0

MutualAuth

Specifies whether to use the Mutually authenticate the session when connecting with SSL option which is specified in Exchange Proxy Settings in Microsoft Outlook during a profile creation.

Required: Yes

Value: 1 or 0

HTTPFirstOnFast

Specifies whether to use the On fast networks, connect using HTTP first, then connect using TCP/IP option which is specified in Exchange Proxy Settings in Microsoft Outlook during a profile creation.

Required: Yes

Value: 1 or 0

HTTPFirstOnSlow

Specifies whether to use the On slow networks, connect using HTTP first, then connect using TCP/IP option which is specified in Exchange Proxy Settings in Microsoft Outlook during a profile creation.

Required: Yes

Value: 1 or 0

AuthNtlm

Specifies whether to use the NTLM Authentication method for connecting to proxy server. It is specified in the page Exchange Proxy Settings in Microsoft Outlook during a profile creation.

Required: No (by default the utility uses NTLM authentication method)

Value: 1 or 0

AuthBasic

Specifies whether to use the Basic Authentication method for connecting to proxy server. It is specified in Exchange Proxy Settings in Microsoft Outlook during a profile creation.

Required: No (by default the utility uses NTLM authentication method)

Value: 1 or 0

AuthNegotiate

Specifies whether to use the Negotiate Authentication method for connecting to proxy server. It is specified in Exchange Proxy Settings in Microsoft Outlook during a profile creation.

Required: No (by default the utility uses NTLM authentication method )

Value: 1 or 0

Section [SwitchMessage]

This section is optional. It is used for creating or recreating switch message for mailboxes.

Parameter Details
RecreateSwitchMsg

Specifies whether a Switch message needs to be recreated for each mailbox.

Required: No

Value: 1 or 0

MigrationAgentType

Indicates what version of Switch message should be created.

Required: Yes

Value: one of the following (cannot be empty)

  • Legacy —If mailboxes are migrated by Migration Manager for Exchange Legacy agents.
  • Contemporary — if mailboxes are migrated by ODME or Migration Manager for Exchange MAgE.
TargetServer

The target Exchange server name. Its format depends on target Exchange Server version:

  • Exchange 2010 or lower: FQDN format
  • Exchange 2013 or higher : Mailbox GUID, @ symbol, and the domain part of the user’s primary SMTP address (<Mailbox GUID>@<Domain Part>)

Required: Yes

Value: string (cannot be empty)

IsMAPIEncryptionRequired

Specifies whether the target Exchange organization explicitly requires encryption.

Required: Yes if the target Exchange server is not Microsoft Office 365. Otherwise, no.

Value: 1 or 0

DomainName

The name of the target domain.

Required: Yes if the target Exchange server is not Microsoft Office 365. Otherwise, no.

Value: string (can be empty)

DomainControllers

A semicolon-separated list of all domain controllers in the target domain.

Required: Yes if the target Exchange server is not Microsoft Office 365. Otherwise, no.

Value: string (can be empty)

ExchangeServers

A semicolon-separated list of all target Exchange servers.

Required: Yes if version of the switch message is v5 or v6. Otherwise, no.

Value: string (can be empty)

TargetProxyServer

The target proxy server name in the RPC over HTTP settings.

Required: Yes if MigrationAgentType=Contemporary. Otherwise, no.

Value: string (cannot be empty)

Target

Indicates type of target Exchange server.

Required: Yes if MigrationAgentType=Contemporary. Otherwise, no.

Value: one of the following (cannot be empty):

  • Exchange —if target server is Microsoft Exchange On-Premises
  • O365—– if migration target is Microsoft Office 365 tenant
Target Version

Specifies the target Exchange server version.

Required: Yes if MigrationAgentType=Contemporary. Otherwise, no.

Value: version number of target Exchange server. For example, 14.0.0.0 for Exchange 2010, 15.01.0.0 for Microsoft Office 365

 

Section [Mailboxes]

This section is mandatory for Microsoft Outlook 2010 and Microsoft Outlook 2013. It should contain a list of legacyExchangeDN attribute of source resource mailboxes which should be updated.

Section [MailboxesSMTP]

This section is mandatory for processing Microsoft Outlook 2016 and Microsoft Outlook 2019 profiles. It should contain a list of SMTP addresses of source resource mailboxes to be updated. In case of Microsoft Outlook 2010 and Microsoft Outlook 2013 profiles, the Switch Resource Mailboxes utility looks for SMTP addresses for a list of mailboxes from section [Mailboxes].

Section [TargetMailboxesSMTP]

This section is used for creating or recreating switch message for mailboxes only. It is optional for processing Microsoft Outlook 2010/2013 and should only be specified for processing Microsoft Outlook 2016 and Microsoft Outlook 2019 profiles. It should contain a list of SMTP addresses of target mailboxes to be updated. If this section is empty or not specified, the Switch Resource Mailboxes utility looks for target SMTP address AD property for each mailbox from a list of mailboxes in section [MailboxesSMTP] by querying Active Directory.

SwitchResMB.ini Example

Below is an example of the INI file for Switch Resource Mailboxes utility if your target is Exchange Server 2010 or earlier and Microsoft Outlook 2010/2013 is used:
[Settings]
CPUUCmdLine=
SrcExchServer=Source
LogonNetworkSecurityNegotiate=1
[Mailboxes]
/o=SourceOrg/ou=Exchange  Administrative  Group  (FYDIBOHF23SPDLT)/cn=Recipients/cn=Room-1
/o=SourceOrg/ou=Exchange  Administrative  Group  (FYDIBOHF23SPDLT)/cn=Recipients/cn=Room-2
/o=SourceOrg/ou=Exchange  Administrative  Group  (FYDIBOHF23SPDLT)/cn=Recipients/cn=Room-3

If you want to create switch message add the following two sections:

[AD]
DCName=DC.source.domain
DCAccount=source\administrator
DCPassword=7F3A62CD00FC1DDDCD
[SwitchMessage]
MigrationAgentType=Legacy
TargetServer=Target
IsMAPIEncryptionRequired=1
ExchangeServers=ex1.target.domain  ex2.target.domain
DomainName=  target.domain DomainControllers=dc.target.domainl
 
Below is an example of the INI file for Switch Resource Mailboxes utility if your target is Exchange Server 2013 or higher and Microsoft Outlook 2010/2013 is used:
[Settings]
CPUUCmdLine=
SrcExchServer=Source
LogonNetworkSecurityNegotiate=1
[RPCOverHTTP]
ConnectUsingHTTP=1
ProxyServer=proxy.source.domain
SSLOnly=0
MutualAuth=0
PrincipalName=
HTTPFirstOnFast=1
HTTPFirstOnSlow=0
AuthNtlm=1
[Mailboxes]
/o=SourceOrg/ou=Exchange  Administrative  Group  (FYDIBOHF23SPDLT)/cn=Recipients/cn=Room-1
/o=SourceOrg/ou=Exchange  Administrative  Group  (FYDIBOHF23SPDLT)/cn=Recipients/cn=Room-2
/o=SourceOrg/ou=Exchange  Administrative  Group  (FYDIBOHF23SPDLT)/cn=Recipients/cn=Room-3

If you want to create switch message add the following two sections:

[AD]
DCName=DC.source.domain
DCAccount=source\administrator
DCPassword=7F3A62CD00FC1DDDCD
[SwitchMessage]
MigrationAgentType=Contemporary
Target=Exchange
TargetVersion=15.0.1076.9
TargetServer=a966e7da-0339-4ae9-9ba7-a9d8016e93ee@target.domain
TargetProxyServer=proxy.target.domain
IsMAPIEncryptionRequired=1
ExchangeServers=ex1.target.domain  ex2.target.domain
DomainName=  target.domain DomainControllers=dc.target.domain
 
Below is an example of the INI file for Switch Resource Mailboxes utility if Microsoft Outlook 2016/2019 is used:
[Settings]
CPUUCmdLine=
SrcExchServer=
[MailboxesSMTP]
Room-1@source.domain
Room-2@source.domain
Room-3@source.domain

If you want to create switch message add the following two sections:

[AD]
DCName=DC.source.domain
DCAccount=source\administrator
DCPassword=7F3A62CD00FC1DDDCD
[SwitchMessage]
MigrationAgentType=Contemporary
Target=Exchange
TargetVersion=15.0.1076.9
TargetServer=a966e7da-0339-4ae9-9ba7-a9d8016e93ee@target.domain
TargetProxyServer=proxy.target.domain
IsMAPIEncryptionRequired=1
ExchangeServers=ex1.target.domain  ex2.target.domain
DomainName=  target.domain DomainControllers=dc.target.domain
OR add the following two sections:
[TargetMailboxesSMTP]
Room-1@target.domain
Room-2@target.domain
Room-3@target.domain
[SwitchMessage]
MigrationAgentType=Contemporary
Target=O365
TargetVersion=15.1.1076.9
TargetServer=a966e7da-0339-4ae9-9ba7-a9d8016e93ee@target.domain
TargetProxyServer=proxy.target.domain

 

Recommended Values for the CPUU.ini Parameters

It is recommended to edit the CPUU configuration file (CPUU.ini) before you start the Switch Resource Mailboxes utility as suggested below:

[Parameters]

Features= Delegates Rules

Silent=1

Important: When using CPUU in conjunction with Migration Manager for Exchange, there is no defined limit for the maximum number of features that can be processed by CPUU. If you want to process all mailbox features, do not specify a value for the Features parameter. The feature list from the example above is recommended only for resource mailboxes.

However, if you use CPUU in conjunction with ODME, specify Skip=All.

It is also recommended to use the Silent=1 switch so that CPUU does not display any dialog boxes.

SwitchResMB Exit Codes

When the Switch Resource Mailboxes utility finishes, it sets the value of the errorlevel variable based on its exit status. The following bit mask can be used to retrieve Switch Resource Mailboxes utility completion status from the errorlevel code:

0 Processing successfully completed
1 Processing failed with errors
2 Incorrect command line parameters
4 Incorrect parameters in the INI configuration file
8 Unable to create one profile
16 Unable to create all profiles
32 Incorrect CPUU command line
64 Unable to start CPUU for updating profiles
128 Unable to start CPUU for cleanup

Troubleshooting

The following topics describe issues that may occur when working with the Client Profile Updating Utility, and how to resolve them:

関連ドキュメント