Chat now with support
Chat with Support

Migrator for GroupWise 4.7 - Program Parameters Reference Guide

Introduction Parameters for Administrator Components Parameters for the SSDM

gwmigapp.ini [Exchange] section

gwmigapp.ini [Exchange] AddressListName=<NameOfList>
Specifies the name of the identity parameter for the Update-AddressList PowerShell cmdlet, which the batch migrator will run after mailbox-enabling a user-list csv file if UpdateAddressList=1 (also in this [Exchange] section). See the UpdateAddressList parameter description for more information.
gwmigapp.ini [Exchange] AddressPolicyName=<NameOfPolicy>
Specifies the name of the identity parameter for the Update-EmailAddressPolicy PowerShell cmdlet, which the Batch Migrator runs when mailbox-enabling a user-list csv file if UpdateEmailAddressPolicy=1 (also in this [Exchange] section). See the UpdateEmailAddressPolicy parameter description for more information.
Specifies the account number you want to assign to the first admin in an Admin Account Pool group. This parameter combined with the AdminAcctPoolRoleGroupName parameter (see separate listing below) lets you configure account numbers for MFG's Admin Account Pool feature. (Admin Account Pooling is described in chapter 6 of the MFG Administration Guide.) For example:
RoleGroupName is the name of the group whose first number you want to assign, while FirstAccountSeq is the number you want to assign to the first admin in the pool. Defaults are:
string; default = GW Migrator Admins Role Group
Specifies the name of an Admin Account Pool group for which you want to assign account numbers. This parameter combined with the AdminAcctPoolFirstAccountSeq parameter (see separate listing above) lets you configure account numbers for MFG's Admin Account Pool feature. (Admin Account Pooling is described in chapter 6 of the MFG Administration Guide.) For example:
RoleGroupName is the name of the group whose first number you want to assign, while FirstAccountSeq is the number you want to assign to the first admin in the pool. Defaults are:
gwmigapp.ini [Exchange] AdminDomain=<WinDomain>
gwmigapp.ini [Exchange] AdminPassword=<WinPassword>
gwmigapp.ini [Exchange] AdminUsername=<WinUsername>
gwmigapp.ini [Exchange] AuthMechanismType=<keyword>
The default is kerberos, but you may specify another method for the keyword parameter value (case-insensitive). Valid values are:
This parameter and another (LocalExchangeFederationServer, also in this [Exchange] section) together support hybrid Office 365 migration (O365 provisioned by a local proprietary AD) with a local Exchange server and remote mailboxes (on O365) for some or most users. DirSyncEnableRemoteMailbox is a boolean parameter that, when enabled (1), tells the Data Migration Wizard to read the LocalExchangeFederationServer value to remote-mailbox-enable each principal provisioned during AD prep on the local Exchange. This feature therefore requires a valid FQDN value for LocalExchangeFederationServer, as described in that parameter entry below.
gwmigapp.ini [Exchange] DeleteAutocompleteMessages=<#>
Determines whether the Admin-Driven Batch Migrator will delete the IPM.Configuration.Autocompletion message from the Inbox at the end of a data migration run. For example:
gwmigapp.ini [Exchange] DoGALLookupRetry=<#>
Determines whether MFG's Admin-Driven Batch Migrator will skip MAPI retries for GAL lookups. Ordinarily in a GAL lookup the migration app will use the Exchange entry if it is found. If the lookup returns no_such_user the app will simply add it to the migrated item as a one-off SMTP address rather than a link to the target account. However, if the initial call returns any error, the app will retry (repeat the call). In some environments, the retry process can be time- consuming. In these instances, DoGALLookupRetry=0 can be used to skip the retry. For example, DoGALLookupRetry=0 tells the program to not retry a MAPI call when searching the Exchange GAL if the initial call returns an error. By default (1) the program will retry such MAPI calls.
gwmigapp.ini [Exchange] EmailAddressPolicyEnabled=<#>
Determines how the program will set the Exchange option to Automatically update e-mail addresses based on e-mail address policy. (The Automatically update... feature is an Exchange feature, offered as a check box in the Exchange Management Console, on the E-Mail Addresses tab of the Data Properties for each mailbox.) This MFG EmailAddressPolicyEnables parameter specifies whether MFG should automatically enable or disable that Exchange feature for the AD objects in a designated user group. Example:
gwmigapp.ini [Exchange] IncludeGwiseProxyAddrs=<#>
If BPOS-D is selected as the migration target, this IncludeGwiseProxyAddrs boolean parameter determines whether the Admin-Driven Batch Migrator will push GroupWise addresses into AD proxy addresses. By default (0) the Batch Migrator will not push GroupWise addresses into AD proxy addresses. But you can set IncludeGwiseProxyAddrs=1 to let the Batch Migrator push GroupWise addresses into AD proxy addresses. Note that this parameter is ignored if the migration target is not BPOS-D.

Type:

Default:

Occurs in:

New in:

string

[null]

Data Migr

4.7

This parameter and another (DirSyncEnableRemoteMailbox, also in this [Exchange] section) together support hybrid Office 365 migration (O365 provisioned by a local proprietary AD) with a local Exchange server and remote mailboxes (on O365) for some or most users. This LocalExchangeFederationServer value is a string for the FQDN of your local Exchange, which the program will need if DirSyncEnableRemoteMailbox=1 to remote-mailbox-enable each principal provisioned during AD prep on the local Exchange.
gwmigapp.ini [Exchange] MAPIErrorsToRetry=<########>
One of three parameters that together let you configure the Admin-Driven Batch Migrator to retry MAPI calls that return MAPI errors typically caused by network latency issues and/or poor bandwidth. MAPIErrorsToRetry is used in conjunction with the MessageRetryCount and MAPIRetryWait parameters (also in this [Exchange] section): The program will retry the call if its preceding attempt returns any of the error codes specified by the MAPIErrorsToRetry parameter, at intervals specified (in seconds) by MAPIRetryWait, as long as the number of prior retries does not exceed the MessageRetryCount value. (“Retries” do not include the first, original attempt.)
gwmigapp.ini [Exchange] MAPIRetryWait=<##>
One of three parameters that together let you configure the Admin-Driven Batch Migrator to retry MAPI calls that return MAPI errors typically caused by network latency issues and/or poor bandwidth. MAPIRetryWait is used in conjunction with the MessageRetryCount and MAPIErrorsToRetry parameters (also in this [Exchange] section): The program will retry the call if its preceding attempt returns any of the error codes specified by the MAPIErrorsToRetry parameter, at intervals specified (in seconds) by MAPIRetryWait, as long as the number of prior retries does not exceed the MessageRetryCount value. (“Retries” do not include the first, original attempt.)
gwmigapp.ini [Exchange] MessageRetryCount=<#>
One of three parameters that together let you configure the Admin-Driven Batch Migrator to retry MAPI calls that return MAPI errors typically caused by network latency issues and/or poor bandwidth. Mes­sageRetryCount is used in conjunction with the MessageRetryWait and MAPIErrorsToRetry parameters (also in this [Exchange] section): The program will retry the call if its preceding attempt returns any of the error codes specified by the MAPIErrorsToRetry parameter, at intervals specified (in seconds) by MAPIRetryWait, as long as the number of prior retries does not exceed the MessageRetryCount value. (“Retries” do not include the first, original attempt.)
gwmigapp.ini [Exchange] O365AccountSkuId=<YOUR_TENANT_NAME:SKU_PART_NUMBER>
Supports Office 365 licensing when organizations leverage multiple O365 account SKUs. If a Multiple AccountSkus error occurs, then the Batch Migrator has detected multiple accounts and requires that you specify one to use for this feature. The Get-MsolAccountSku cmdlet can retrieve the AccountSkuIds for all valid licenses. Review the list and determine the appropriate SKU for the current licensing operation. Then specify the SKU you want to use in this new parameter in the [Exchange] section of gwmigapp.ini:
gwmigapp.ini [Exchange] O365UsageLocation=<xx>
The mandatory two-letter Usage Location code that Microsoft requires for its Office 365 licenses (per this Microsoft article). The two-letter keyword must conform to the standardized values for ISO 3166-1-alpha-2).
gwmigapp.ini [Exchange] PstFileName=<filename>
Specifies a common output PST filename for all migrating users, when migrating data to PSTs. This value is used in conjunction with the PSTDir column in the user list csv file, which specifies a unique PST directory for each user. The combination of a common PstFileName value with unique PSTDir values assures that the newly created PST files will be identifiable by user. Example:
... combined with PSTDir column values set to \\server\home\user1, user2, user3, etc., would produce these new PST files in these locations:
Otherwise, if the PSTDir column is unspecified and the PstFileName parameter sets the output filename to a common value, the multiple files saved to the same directory would be differentiated only by appended digits: migr-archive 1.pst, migr-archive 2.pst, migr-archive 3.pst, and so forth. Each user in a user-list csv file should therefore have a unique directory specified in the PSTDir column, such as the user's home directory on a server.
If PSTDir columns are specified but the PstFileName setting is left unspecified, the new PST filenames are derived from users' display names.
PurgePABS=1 tells the program to clear the contents of Personal Address Books in Exchange before migrating corresponding PABs from GroupWise—useful if, for example, you had already migrated PABs, but then wanted to migrate them again. The default PurgePABS=0 disables the feature, so no PABs are cleared. This feature clears only Exchange PABs that correspond to GroupWise PABs about to be migrated, and will not clear any other existing Exchange PABs.
gwmigapp.ini [Exchange] RemigrateMode=<#>
0 = always replace: Deletes the Exchange copy of the item and then remigrate it from GroupWise.
1 = never replace: The source item in GroupWise will not be migrated, leaving the previously migrated copy unupdated in Exchange.
2 = replace on change: Replaces a previously migrated message only if the message on the source has been changed since the time of migration.
gwmigapp.ini [Exchange] ServerMailResolveAttendees=<#>
gwmigapp.ini [Exchange] SetResourceToAutoAccept=<#>
Enables or disables the Exchange autoaccept feature for resources. (Autoaccept is an Exchange feature, available only when migrating to Exchange 2013 or 2010, or Office 365.) For example, SetResourceToAutoAccept=1 (the default) tells the Batch Migrator to enable Exchange's autoaccept feature when creating resource mailboxes. To disable the feature, set SetResourceToAutoAccept=0.
gwmigapp.ini [Exchange] ShowResolveAttendeesOpt=<#>
Determines whether the two Resolve attendees... check box fields will appear in the Office 365 Mail Settings screen of the Admin-Driven Batch Migrator program. The check boxes are hidden (ShowResolveAttendeesOpt=0) by default, in which case the features will be enabled (as if both check boxes were marked).
gwmigapp.ini [Exchange] UpdateAddressList=<#>
UpdateAddressList=1 tells the Batch Migrator to run the Update-AddressList PowerShell cmdlet after mailbox-enabling a collection, to complete the AD provisioning of recipients who are only partially provisioned. Update-AddressList will run with its identity parameter set to "All Users" by default, or to some other identity value if set by the AddressListName parameter (also in this [Exchange] section). This can be useful when objects have been provisioned by tools such as Microsoft Identity Integration Server (MIIS) or custom provisioning tools that do not fully provision recipient objects. By default (0), the cmdlet will not run.
gwmigapp.ini [Exchange] UpdateEmailAddressPolicy=<#>
UpdateEmailAddressPolicy=1 tells the Batch Migrator to run the Update-EmailAddressPolicy PowerShell cmdlet after mailbox-enabling a collection, to complete the AD provisioning of recipients who are only partially provisioned. The Update-EmailAddressPolicy cmdlet will run with its identity parameter set to "Default Policy" by default, or to some other identity value if set by the AddressPolicyName parameter (also in this [Exchange] section). This can be useful when objects have been provisioned by tools such as Microsoft Identity Integration Server (MIIS) or custom provisioning tools that do not fully provision recipient objects. By default (0), the cmdlet will not run.
gwmigapp.ini [Exchange] ValidateForwardingAddresses=<#>
This parameter corresponds to the Validate mail-forwarding addresses check box on the Office 365 Mail Settings screen. MFG writes this value to the INI file from the GUI entry; Quest recommends you not manually enter or change this value except at the direction of Quest Support.
gwmigapp.ini [Exchange] VerifyO365AdminRights=<#>
Determines whether the program, when migrating to Office 365, will bypass the Get-MailBoxPermission and Add-MailBoxPermission checks, and assume that it already has the necessary rights to proceed with the migration. This can be useful if, due to security standards and/or regulations, you prefer to not give the MFG migration account Organization Management rights to your entire O365 environment. By default (VerifyO365AdminRights=1) the program will perform the Get-MailBoxPermission and Add-MailBoxPermission checks.
gwmigapp.ini [Exchange] WriteMessageRetryWait=<##>
One of two parameters that let you configure the Admin-Driven Batch Migrator to retry the migration of an entire message when an error causes the overall message to fail. This WriteMessageRetryWait parameter tells the program how long to wait (in seconds) between successive attempts to migrate a message. See the WriteMessageTryCount parameter notes (below) for more information and an example.
gwmigapp.ini [Exchange] WriteMessageTryCount=<#>
This WriteMessageTryCount parameter tells the program how many times to try to migrate a message, at intervals specified by the WriteMessageRetryWait value (number of seconds), before giving up the attempts. If a message fails again on the last attempt, the program notes the failure in its log and resumes processing with the next message. By default (WriteMessageTryCount=1) the program will try only once (and not retry at all).
This feature can complement the MAPI-error retry feature, which permits retries at the MAPI-error level (see the MessageRetryCount parameter above, also in this [Exchange] section). At the MAPI-error level, if a MAPI error remains unresolved after the specified number of retry attempts, the program notes the error in its log and resumes processing with the next element or property of the message. But if an error causes an entire message to fail, these message-retry parameters let you tell the program to retry processing the entire message, from the beginning, at specified intervals, through a specified number of iterations.

gwmigapp.ini [Filter] section

gwmigapp.ini [Filters] section

gwmigapp.ini [Filters] Filter[#]=<AlphanumString>

gwmigapp.ini [FolderNames] section

The JUNK parameter value is a keyword that tells the program to create a folder named “Junk E-mail,” which prevents Outlook 2003 from automatically creating its own Junk E-mail folder upon start-up. For example: ~JUNKMAIL=JUNK
Related Documents