manageprofile

manageprofile is a command-line tool for managing and testing MAPI profiles. It can be used as a replacement for the NTWMS tool. manageprofile can be used to:

• List the currently configured MAPI profile(s)
• Open an Exchange mailbox using MAPI as well as CDO via the GAL application
• Create a new MAPI profile
• Edit an existing MAPI profile
• Delete an existing MAPI profile

Operational events and errors are logged in a user-defined text file for review and troubleshooting.

The manageprofile utility is installed in the bin\ and util\ folders in the Good Messaging Server installed location.

Run the tool from the command line. To run the utility on another computer, you must copy all of the files (including all dll's) from the util directory.

Syntax:

manageprofile -profile profilename -operation <none/edit/delete> -showgal <yes/no> -log filepath
-reconnflags <yes/no>

To list the currently configured MAPI profile(s), enter the following command:

manageprofile -profile "" -operation none -showgal no -log c:\manageprofile\log.txt

This command will output a list of MAPI profile names as well as related attribute information for each profile. Sample output followed by an explanation of each item:

List of all MAPI profiles for the user:'SOUTHAMERICA\svcpine2003' (Please wait...)

ProfileName[1]:"GoodLink Server" [Connected:Yes, ExchSrv:BRAZILEXCH2K3, Mailbox:svcpine2003, Default:No, Offline:No, GCSrv:chiledc1.southamerica.qagood.com]

Description of the profile attributes:

Connected: (Yes/No) - Indicates whether the logged-on user is able to log on with 'logon network security' set to 'NT Password Authentication'. If this is 'No', then it is a sign of trouble. If the profile is set to offline also, this will show as 'No'

ExchSrv - Name of the resolved Exchange server. If "CheckName" was not pressed in the profile, this may be empty. An empty value here is a sign of trouble.

Mailbox - Name (alias or display name) of the resolved Exchange User. If "CheckName" was not pressed in the profile, this may be empty. An empty value here is a sign of trouble.

Default: (Yes/No) - Whether this profile is set to default. This value is not significant for non-Outlook environments.

Offline:(Yes/No) - Whether the profile is Offline or set to "Use Local Copy of Mailbox."

GCSrv - Name of the Global Catalog Server that the profile is connecting to. This value will be present only if connecting to Active Directory and E200x environments. An empty value here is OK. If this value is present, make sure that it is pointing to the correct Active Directory domain controller/Global Catalog Server.

Example log entry for unresolved profile:

12-04-2003 10-51-01 ProfileName[6]:"unresolved" [Connected:No, ExchSrv:, Mailbox:, Default:No, Offline:No, GCSrv:]

To test access to a mailbox via MAPI and CDO, enter the following command:

manageprofile -profile profileName -operation none -showgal yes -log c:\manageprofile\log.txt

When this command is entered, a Global Address List (GAL) application will be launched. Select the user from the list to be tested and then click on the [OK] button. If successful, the following popup window will be displayed.

Opened 'Angel Bocan' mailbox using MAPI and CDO. Please see file 'c:\manageprofile\log.txt' for mailbox details

Click [OK] button to return to GAL application to test another mailbox. From the GAL application, click [Cancel] button to return to command prompt.

To create a new MAPI profile, enter the following command:

manageprofile -profile newProfileName -operation edit -showgal no -log c:\manageprofile\log.txt

When this command is entered, a MAPI profile window will be launched. In the General tab, enter the Microsoft Exchange Server name and enter the Mailbox name. Select the [Check Name] button to resolve the mailbox name - it will underline if mailbox resolves successfully.

To edit an existing MAPI profile, enter the following command:

manageprofile -profile profileName -operation edit -showgal no -log c:\manageprofile\log.txt

When this command is entered, a MAPI profile window will be launched. In the General tab, the Microsoft Exchange Server name and the Mailbox name will be displayed. Modify values as appropriate.

To delete an existing MAPI profile, enter the following command:

manageprofile -profile profileName -operation delete -showgal no -log c:\manageprofile\log.txt

To view the log, enter the following command:

notepad log.txt