ZCS Administrator Guide 8.0
ZCS Administrator Guide 8.0
Network Edition


Administering the Import Wizard > Importing Multiple PST Files Using the Windows CLI Utility

Importing Multiple PST Files Using the Windows CLI Utility
You can import a large number .pst files to a single ZCS account using the Windows CLI utility and an XML file specifying the import settings.
The XML file must contain five elements inside of the XML root element, ZCSImport: Server, Account, Data, Options, and Import. Each element, except for the Import element, should have a name attribute. These name attributes will be used in the Import element to distinguish between elements that have been used more than once.
The following list contains all elements that should be contained in the root element, and their child elements.
*
Server. This element contains information about the ZCS server that will receive the .pst files.
serverName. The value of this element is the name of the ZCS server.
port. The value of this element is the server port to use. The default is 443.
sslEnabled. The value of this element indicates whether to use a secure connection (SSL). A value of 0 indicates that SSL will not be used. A value of 1 indicates that SSL will be used. The default value is 1.
*
Account. This element contains login information for the specified account. There can be more than one Account element. You will specify in the Import element whether the account should be the import target or the authentication account.
userName. The value of this element is the ZCS user account in the form of user@domain.com.
password (optional). The value of this element is the password for the specified user in the userName element. If the password element is not included, you will be prompted for the password at the time of import. In order to import a user’s documents without their password, create an additional Account element for an administrator’s ZCS account, and specify the administrator’s account as the authAccount in the Import element.
organizerEmail (optional). The value of this element is the old account of the user in the form of user@domain.com. When included, this element indicates that meetings organized with the target user’s old account will be converted to their new account.
*
Data. This element contains information indicating which .pst files will be imported. There can be more than one Data element.
PST. The value of this element is a single .pst path. Use this element for each .pst file to import.
*
Options. This element contains information indicating the import settings for the .pst files being imported. There can be more than one Options element.
importDeletedItems. The value of this element indicates whether to import items in the target user’s Deleted Items (trash) folder. A value of 0 indicates that deleted items will not be imported. A value of 1 indicates that deleted items will be imported. The default value is 1.
importJunk. The value of this element indicates whether to import items in the target user’s Junk-Mail folder. A value of 0 indicates that junk mail will not be imported. A value of 1 indicates that will be imported. The default value is 1.
importPartialMails. The value of this element indicates whether to import messages without a body. Users who have configured their IMAP to download only message headers will be affected by this element. A value of 0 indicates that messages without a body will not be imported. A value of 1 indicates that messages without a body will be imported. The default value is 1.
ignorePreviouslyImported. The value of this element indicates whether to ignore previously imported items. A value of 0 indicates that previously items will be imported again. A value of 1 indicates that previously imported items will be ignored. The default value is 1.
startDate (optional). The value of this element specifies what date to begin importing messages. The date should be in the form of MM/DD/YYYY. If this element is not present, all messages will be imported.
ADLookup (optional). This element contains the Active Directory server. If this element is not present, automatic ADLookups will be attempted to resolve Exchange addresses. If the automatic ADLookups fail, the Exchange addresses will not be resolved and some of the imported emails will have blank To and From fields.
ADServer. The value of this element is the name of the Active Directory server.
ADUser. The value of this element is the user’s Active Directory user name.
ADPassword. The value of this element is the user’s Active Directory password. If this element is not present, and the AD user value is different than the currently logged on user, an error is logged and the Import Wizard will quit.
InvalidSSLOk. The value of this element indicates whether to continue in the case of an invalid SSL certificate. A value of 0 indicates not to continue. A value of 1 indicates to continue. The default value is 0.
IgnoreCoreDump. This value of this element indicates whether to continue without the ability to generate a core dump in the case of unexpected errors. A value of 0 indicates not to continue. A value of 1 indicates to continue. The default value is 0.
*
Import. This element specifies with its attributes which of the above elements to use. There can be more than one Import element. The following items are attributes of the Import element.
Server. This attribute specifies the name of the Server element to use.
TargetAccount. This attribute specifies the name of the Account element containing the account to import the .pst files to. You can specify multiple TargetAccount attributes.
AuthAccount (optional). This attribute specifies the name of the Account element used to log in to the ZCS server. If this attribute is not present, the TargetAccount attribute will be used to log in to the ZCS server. If you are specifying more than one TargetAccount, the AuthAccount should contain an account with administrator access.
AdminPort. This attribute specifies the port to use when using the account specified in the AuthAccount element. This attribute must be present if the AuthAccount is present.
AdminSSLEnabled (optional). This attribute indicates whether to use a secure connection (SSL) when using the account specified in the AuthAccount element. A value of 0 indicates not to use SSL. A value of 1 indicates to use SSL. The default value is 1.
Data. This attribute specifies the name of the Data element containing the .pst files to import. You can specify multiple Data attributes.
Options. This attribute specifies the name of the Options element containing the import options to use.
The following is an example of an XML settings file:
 
 
When you have created the XML file with your import settings, save it to the same location as the Import Wizard. In order to use this XML file to import multiple .pst files, use the following steps:
To import .pst files from the Windows CLI
1.
2.
3.
For example:
“C:\Documents and Settings\User\ZCSPSTImportWizard.exe” configuration.xml
4.
The Import Wizard will begin to import the .pst files according to the settings in your XML file. If you have not specified passwords in your XML file, you will be prompted for them during the import process.
Copyright © 2012 VMware Inc.