Before starting the Switch Resource Mailboxes utility, you should take the following steps:
- 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 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. |
- 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.
- 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:
Required: Yes Value: string (cannot be empty for Microsoft Outlook 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 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)
|
| Target |
Indicates type of target Exchange server. Required: Yes if MigrationAgentType=Contemporary. Otherwise, no. Value: one of the following (cannot be empty):
|
In case the configuration file is created using previous versions of CPUU it can contain more parameters, but only the parameters specified above are used.
Section [Mailboxes]
This section is mandatory for 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 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 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 source is Exchange Server 2010 or earlier and Microsoft Outlook 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 no switch message exists in the source resource mailbox, СPUU (SwitchResMB) will create switch messages, and to do this, you need to add the following two sections:
[AD]
DCName=DC.source.domain
DCAccount=source\administrator
DCPassword=7F3A62CD00FC1DDDCD
[SwitchMessage]
MigrationAgentType=Legacy
Below is an example of the INI file for Switch Resource Mailboxes utility if your source is Exchange Server 2013 or higher and Microsoft Outlook 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 no switch message exists in the source resource mailbox, СPUU (SwitchResMB) will create switch messages, and to do this, you need to add the following two sections:
[AD]
DCName=DC.source.domain
DCAccount=source\administrator
DCPassword=7F3A62CD00FC1DDDCD
[SwitchMessage]
MigrationAgentType=Contemporary
Target=Exchange
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 no switch message exists in the source resource mailbox, СPUU (SwitchResMB) will create switch messages, and to do this, you need to add the following two sections:
[AD]
DCName=DC.source.domain
DCAccount=source\administrator
DCPassword=7F3A62CD00FC1DDDCD
[SwitchMessage]
MigrationAgentType=Contemporary
Target=Exchange
OR add the following two sections:
[TargetMailboxesSMTP]
Room-1@target.domain
Room-2@target.domain
Room-3@target.domain
[SwitchMessage]
MigrationAgentType=Contemporary
Target=O365
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 |