Logo

Documentation home for Transend tools

Microsoft 365 Drive ID Collection script

Use m365_get_drive_ids.ps1 to inventory the shared drives in a Microsoft 365 account and create a CSV formatted for Transend Migration Console. Shared-drive names are not guaranteed to be unique, so the migration project needs each drive’s unique ID to identify the correct source. The -Target option adds the destination columns required for a Google Workspace, Microsoft 365, or local-file migration, giving you a mapping file that you can complete and import.

Setup

  1. Download TMCTools.
  2. From the TMCTools zip file, extract common.psm1, m365.psm1 and m365_get_drive_ids.ps1 from the TMCTools/bin folder.
  3. Ensure you have created the required app using m365_initialize_app.ps1.

Usage

.\m365_get_drive_ids.ps1
  -AppId <AppId>
  -AppSecret <AppSecret>
  -TenantId <TenantId>
  -Target <Google | M365 | Local>
  [-CloudEnvironment <Default | DoD | GCCHigh | China | Germany>]

Parameters

Parameter Required Values Description
-AppId Yes App ID The application ID to use for authentication.
-AppSecret Yes App secret The application secret to use for authentication.
-TenantId Yes Tenant identifier The tenant ID to connect to.
-Target Yes Google, M365, Local The provider you are migrating to.
-CloudEnvironment No Default, DoD, GCCHigh, China, Germany The cloud environment to connect to. Use this option if your tenant is not in the worldwide cloud.

Examples

Example 1: Collect drive IDs for migrating to Google Workspace

.\m365_get_drive_ids.ps1 -AppId '8b26caf2-2ef6-4a9d-9c27-98616d1c1294' -AppSecret '9pitRZoTezs6M0b~bgcibEfkG6qMaczuNV25Ol6m' -TenantId 'example.org' -Target 'Google'

Example 1: Collect drive IDs for migrating to Microsoft 365

.\m365_get_drive_ids.ps1 -AppId '8b26caf2-2ef6-4a9d-9c27-98616d1c1294' -AppSecret '9pitRZoTezs6M0b~bgcibEfkG6qMaczuNV25Ol6m' -TenantId 'example.org' -Target 'M365'

Example 3: Collect drive IDs for migrating to the local filesystem or a file share

.\m365_get_drive_ids.ps1 -AppId '8b26caf2-2ef6-4a9d-9c27-98616d1c1294' -AppSecret '9pitRZoTezs6M0b~bgcibEfkG6qMaczuNV25Ol6m' -TenantId 'example.org' -Target 'Local'

Troubleshooting

  • Review the log file in your Documents directory for more information.