Logo

Documentation home for Transend tools

  • Compare-M365SharedDrives
  • Compare-M365UserDrive
  • Compare-M365UserDrives
  • Copy-M365SharedDrives
  • Copy-M365UserDrive
  • Copy-M365UserDrives
  • Export-M365Applications
  • Export-M365CalendarEvents
  • Export-M365Calendars
  • Export-M365ChannelMessages
  • Export-M365DirectoryObjects
  • Export-M365Domains
  • Export-M365Groups
  • Export-M365Mailboxes
  • Export-M365OrgLicenses
  • Export-M365OrgUnits
  • Export-M365Resources
  • Export-M365SharedContacts
  • Export-M365SharedDrives
  • Export-M365SharedMailboxes
  • Export-M365Sites
  • Export-M365TeamChannels
  • Export-M365Teams
  • Export-M365Users
  • Import-M365Groups
  • Import-M365Resources
  • Import-M365SharedContacts
  • Import-M365SharedMailboxes
  • Import-M365Sites
  • Import-M365TeamChannels
  • Import-M365Teams
  • Import-M365Users
  • Measure-M365SharedDrives
  • Measure-M365UserDrive
  • Measure-M365UserDrives
  • Move-M365SharedDrives
  • Move-M365UserDrive
  • Move-M365UserDrives
  • Show-M365SharedDrives
  • Show-M365UserDrive
  • Show-M365UserDrives
  • Sync-M365Groups
  • Sync-M365SharedDrives
  • Sync-M365UserDrive
  • Sync-M365UserDrives
  • Update-M365Groups
  • Update-M365LocalCache
  • Update-M365Resources
  • Update-M365SharedContacts
  • Update-M365SharedMailboxes
  • Update-M365Sites
  • Update-M365TeamChannels
  • Update-M365Teams
  • Update-M365Users
  • m365_get_drive_ids
  • m365_initialize_app
  • m365_initialize_archives
  • m365_initialize_drives
  • m365_initialize_ews
  • m365_initialize_graph
  • m365_initialize_imap
  • m365_initialize_sharepoint
  • m365_restore_archives
  • m365_restore_ews
  • m365_restore_graph
  • m365_restore_imap
  • m365_restore_sharepoint

    • Home

    Microsoft 365 Initialize App script

    Use m365_initialize_app.ps1 to create and configure the Microsoft Entra ID app that Transend products use to connect to Microsoft 365.

    After the migration is complete, remove the app registration if it is no longer needed, following your organization’s application-retirement process.

    Setup

    1. Download TMCTools.
    2. From the TMCTools zip file, extract common.dll, m365.dll and m365_initialize_app.ps1 from the TMCTools/bin folder.

    Usage

    .\m365_initialize_app.ps1
  -TenantId <TenantId>
  [-AddTmcTools]
  [-CloudEnvironment <Default | DoD | GCCHigh | China | Germany>]

    Parameters

    Parameter Required Values Description
    -TenantId Yes Tenant identifier The tenant ID to connect to.
    -AddTmcTools No Switch Include TMCTools permissions in addition to TMC permissions.
    -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: Create the default migration app

    .\m365_initialize_app.ps1 -TenantId 'example.org'

    Example 2: Create an app for TMC and TMCTools

    .\m365_initialize_app.ps1 -TenantId 'example.org' -AddTmcTools

    Troubleshooting

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