- Run GSMME on a Microsoft Windows computer and select the option to migrate public folders.
- Run GSMME from a command line. This advanced procedure is meant for experienced administrators.
Public folders in Exchange are common folders for sharing information with all authorized users, or groups of users, in your organization. Public folders can support messages, calendar events, contacts, notes, and so on.
Public folders are used to post and archive messages. When you post, you're not creating an email and sending it to an inbox. Instead, messages are posted to the public folder and can be viewed when navigating to the folder.
GSMME can migrate posted messages from public folders to Groups. File types not blocked by Gmail are migrated. Files are stored as attachments to posts in Groups. Learn more about File types blocked in Gmail.
Although public folders in Exchange support calendar events, contacts, and notes, GSMME does not migrate any of these data types.
Before you begin
- Run separate migrations for user data and public folders—You can't migrate user data and public folders at the same time. Migrate your users' mail, calendar, and contacts data first. Then, migrate public folders.
- The public folder and subfolder hierarchy can't be replicated in Groups—Google Groups can't be arranged into a hierarchy like Exchange subfolders. You can map the Exchange subfolders to a group or you can create separate groups for each subfolder.
- Create groups first—You need to set up your groups and group memberships in Google Workspace before running the migration.
- Specify nested public folders—To migrate a nested public folder, you must specify it separately in the mapping file.
Before you can install GSMME, you must authorize the software for your domain. For details, go to Authorize GSMME for your account.
You can create groups and add users to them with the Google Admin console, the Groups API, or the Google Groups for Business service. Learn more
To retrieve your public folder names, open Exchange Management Shell and specify
Important: If you're migrating public folders in default mode using the command line, you can skip this step. Learn more
Map the public folders in Exchange to the Google Group you want to migrate the data to. In the file, specify the folder name in Exchange and the corresponding group email address. Ensure the Exchange folder is consistently named with how it appears in Microsoft Outlook, especially if the language isn't set to English.
The mapping file can be a .csv (comma-separated values) or .txt (text) file. Save it to a folder that's easily located.
ExampleAll Public Folders/Finance/annual report, firstname.lastname@example.org
All Public Folders/TPS reports/tps reports, email@example.com
All Public Folders/Offshore/accounts, firstname.lastname@example.org
Use the GSMME interface or the command line to migrate public folders.Use the GSMME interface to migrate
Step 1: Exchange server details
- Run GSMME: Click StartG Suite MigrationG Suite Migration for Microsoft Exchange.
- For Server Type, select Exchange.
- Select the Specify a profile to use for migration option.
- In the Outlook Admin Profile field, select the pre-created Outlook profile of the Exchange administrator you want to use to sign in to your Exchange server.
To create an Outlook profile for the Exchange administrator, follow these detailed steps.
- Click Next.
Step 2: User and domain information
- In the G Suite domain name field, specify the new primary Google Workspace domain where the data will be migrated.
- In the Service account credentials file field, specify the path to the JSON credentials file created as part of the authorization process.
- In the G Suite admin user field, specify the full email address of your Google Workspace domain super administrator.
- Click Next to specify the migration settings.
Step 3: Migration settings
- Check the Public Folders box as the type of data you want to migrate.
- In the File of folders to migrate field, specify the path to the mapping file created in step 3 above.
- Click Next.
- Review the migration settings and optionally make changes.
- Select your migration actions:
- Migrate all data—When checked, the utility remigrates previously migrated data during the migration. When unchecked, previous items that were migrated successfully are skipped.
- Save settings—When checked, the utility retains the current configuration for future use.
- Migrate—When checked, the utility performs the migration.
- Click Next.
There are 2 options to migrate public folders using the command line:
- (Recommended) Mapping mode—In mapping mode, you specify the path to the mapping file from step 3. The file specifies the links between the public folder and the group in Google Groups.
- Default mode—In default mode, you don't need to provide a mapping file. The migration is run against folder and group names. The mapping is established when the public folder name directly matches the group name. For example, Solarmora Public Folders/Finance maps to email@example.com.
Since group email addresses usually don't match public folder names, most organizations use mapping mode.
For details on commands, go to Run GSMME from the command line.
Note: If you're using a 64-bit operating system, you need to use
Program Files (x86) instead of
Program Files in the command.
Option 1. Run a migration in mapping mode
Specify the following commands:
"C:\Program Files\Google\G Suite Migration\ExchangeMigration.exe" --nouse_gui --exchange_profile_name="Exchange administrator profile" --google_domain="Google domain name" --service_account_json_path="json file path" --gsuite_admin="g suite administrator email address" --public_folder_mapping_file="path to mapping file" --enable_public_folder_migration --force_restart
"C:\Program Files\Google\G Suite Migration\ExchangeMigration.exe" --nouse_gui --exchange_profile_name="Exchange migration administrator profile" --google_domain="example.com" --service_account_json_path="C:\Users\admin\privatekey.json" --gsuite_admin="firstname.lastname@example.org" --public_folder_mapping_file="public_folder_mapping.csv" --enable_public_folder_migration --force_restart
Option 2. Run a migration in default mode
Specify the following commands:
"C:\Program Files\Google\G Suite Migration\ExchangeMigration.exe" --nouse_gui --exchange_profile_name="Exchange administrator profile" --google_domain="Google domain name" --service_account_json_path="json file path" --gsuite_admin="g suite administrator email address" --enable_public_folder_migration --force_restart
"C:\Program Files\Google\G Suite Migration\ExchangeMigration.exe" --nouse_gui --exchange_profile_name="Exchange migration administrator profile" --google_domain="example.com" --service_account_json_path="C:\Users\admin\privatekey.json" --gsuite_admin="email@example.com" --enable_public_folder_migration --force_restart
Note: Each example command above is a continual single line. Any line breaks visible here are for readability only.
Is it possible to migrate only the messages (and not the documents) from the public folder?
Yes. If you're running GSMME, you can exclude specific message classes using the command line:
Are migrated documents and attachments searchable?
Yes. You can search for attachments by using the Google Groups search parameter
has:attachment and by attachment names.
Are migrated posts delivered to group members?
No. Migrated posts are only inserted into the group archive.
What message classes does GSMME migrate from public folders?
The following message classes are migrated from public folders: IPM.Note, IPM.Post, IPM.Schedule.Meeting.Request, IPM.Schedule.Meeting.Canceled, IPM.Schedule.Meeting.Resp, and IPM.
Does GSMME migrate the read or unread status of public folder posts?
No. GSMME doesn't migrate the read or unread status or other user-level metadata for public folder posts.
Google, Google Workspace, and related marks and logos are trademarks of Google LLC. All other company and product names are trademarks of the companies with which they are associated.