Create, Manage, Move, Export, Disable Exchange Mailbox

With the Exchange Mailbox Tasks, you can perform actions in a consistent manner, without the risk of inconsistencies in the data entered manually in Exchange itself.

Use the Tasks Create, Manage and Move to create, manage and move mailboxes on Microsoft Exchange servers.
Use the Task Export Exchange Mailbox to export mailboxes on Microsoft Exchange servers to a PST file. This is useful when you want to back up or archive Exchange mailboxes, for example before deleting mailboxes or for legal purposes.
Use the Task Disable Exchange Mailbox to disable mailboxes on Microsoft Exchange servers. This will remove all Exchange attributes from the corresponding Active Directory user accounts. The user account itself will be retained. By default, Exchange will retain disabled mailboxes for 30 days. It is possible to reconnect disabled mailboxes to an Active Directory user account within this retention period.

Permissions and prerequisites to create, manage, move or disable Exchange mailboxes

Permissions and prerequisites to export Exchange mailboxes

Configuration

When configuring a Task Create Exchange Mailbox, the User name on the Settings tab is the user logon name (pre-Windows 2000).

When configuring a Task Manage Exchange Mailbox to manage mailboxes on Microsoft Exchange Server 2010 or higher, use the E-Mail Addresses tab to add primary and other SMTP e-mail addresses or to remove these e-mail addresses for Active Directory users with existing Exchange e-mailboxes. When using Microsoft Exchange Server 2003 or 2007 (only applicable for legacy Agent) you need to do this by configuring a Task Manage Active Directory User.

You can only add e-mail addresses for Active Directory Users with existing Exchange e-mailboxes. When specifying e-mail addresses you can use and combine Windows variables. The options are provided when you right-click the E-mail addresses field, but you can also type them in as required.

Examples

Variable	Stands for	Example for user Dan P. Harris
%g	Given name (first name)	%g yields dan
%[x]g	Uses x number of letters of the given name.	%1g yields d
%i	Middle initial	%i yields p
%s	Surname (last name)	%s yields harris
%d	Display name	%d yields Dan Harris (or Dan P. Harris. depending on the configured display name)
%[x]s	Uses x number of letters of the surname.	%3s yields har
%m	Exchange alias

Example of combined variables (for Dan P. Harris):

%1g%s yields dharris
%s%1g yields harrisd
%s%g yields harrisdan
%1g%i%s yields dpharris

If you want to remove a primary e-mail address, set another as primary first.
By default, any specified e-mail addresses are added to any existing e-mail addresses. To replace existing lists with the list defined in the Task, select Replace all existing SMTP e-mail addresses.

When configuring a Task Export Exchange Mailbox, in the PST file name field on the Mail Properties tab, provide a location where the PST file can be stored. Click to browse to a location. If you specify a location where a PST file of the same name already exists, the old file will be replaced by the new one.

When you configure a Task to change, move, export or disable Exchange mailboxes that match a set of criteria, there is a risk that more Exchange mailboxes are targeted than expected. By selecting the option Fail this Task if the number of items affected exceeds [x], you can create a safety net that prevents undesired results.

Tasks Move Exchange Mailbox that move mailboxes from older versions of Microsoft Exchange Server to Microsoft Exchange Server 2010 or vice versa should only be scheduled on Agents running Microsoft Exchange Server 2010.

When configuring a Task Create Exchange Mailbox, you can configure a condition that sets a parameter, and make the Exchange folder in which the mailbox should be created dependent on the surname of the user. The value of the parameter can then determine whether the Task should be executed or skipped.
Example scenario
Suppose you have two Exchange servers. On server 1, you create mailboxes for users with surnames starting with A-M. On server 2, you create mailboxes for users with surnames N-Z. User names consist of only the user's surname. This can be set up in Ivanti Automation using a Project containing two Modules:
- The Module "Mailbox on Server 1" contains a Task to create an Exchange Mailbox on server 1; and the Module parameter $[surname] is set in the user name field.
- The Module "Mailbox on Server 2" contains a Task to create an Exchange Mailbox on server 2; and the Module parameter $[surname] is set in the user name field.
- The Project parameter $[surname] is linked to both Module parameters $[surname].
To configure the value of the parameter $[surname] as the basis for the condition to skip either Module 1 or Module 2:
1. Configure a condition for the Module "Mailbox on server 1":
  1. Select the Module "Mailbox on Server 1" on the Project's Modules tab.
  2. Click Condition and click Add > Parameter.
  3. Configure the condition: surname LIKE [n-z]* and click OK.
  4. Under Action, configure If condition is true, skip this Module.
  5. Click OK to return to the Modules tab.
2. Configure a condition for the Module "Mailbox on server 2":
  1. Select the Module "Mailbox on Server 2" on the Project's Modules tab.
  2. Click Condition and click Add > Parameter.
  3. Configure the condition: surname LIKE [a-m]* and click OK.
  4. Under Action, configure If condition is true, skip this Module.
  5. Click OK to return to the Modules tab.
3. Close the Project and schedule it as a Job.
If you provide the surname Zimmerman as value for the parameter $[surname], then Module 1 will not meet the condition and will be skipped. Module 2 will meet the condition, and will be executed, so the mailbox is created on server 2.
If you provide the surname Johnson, it works the other way around: Module 1 is executed and Module 2 is skipped.
For a Task Export Exchange Mailbox, when you specify %username% in the PST file name, Ivanti Automation will automatically convert this variable to the name of the mailbox user.