Edit

Share via

Get-TenantPrivateChannelMigrationStatus

Module:
MicrosoftTeams PowerShell module

You use the Get-TenantPrivateChannelMigrationStatus cmdlet to check the status of private channel migration for your tenant.

Syntax

Default (Default) 

Get-TenantPrivateChannelMigrationStatus

Description

The Get-TenantPrivateChannelMigrationStatus cmdlet allows tenant administrators to track the status of the private channel migration for their Microsoft Teams organization. More details about the migration can be found here

Note: This cmdlet requires tenant administrator permissions to execute.

Examples

Example 1

This example retrieves the private channel migration status for the current tenant.

Get-TenantPrivateChannelMigrationStatus


TenantId                     : 12345678-1234-1234-1234-123456789abc
MigrationStatus              : Completed
MigrationStartTimeStamp      : 2025-10-09T10:15:00.456Z
MigrationCompletionTimeStamp : 2025-10-09T12:45:00.789Z

Inputs

None

This cmdlet does not accept pipeline input.

Outputs

System.Object

This cmdlet returns a PrivateChannelMigrationStatusResponse object with the following properties:

TenantId: The Azure AD tenant identifier for your organization.

MigrationStatus: The current migration status for private channels in your tenant.

MigrationStartTimeStamp: The timestamp when the migration started for this tenant.

MigrationCompletionTimeStamp: The timestamp when the migration completed for this tenant.

Notes

  • This cmdlet requires tenant administrator permissions
  • The cmdlet connects to the Teams and Channels service to retrieve migration status information
  • Private channels remain functional throughout the migration process
  • This enhancement helps make private channels more scalable, manageable, and compliant

Common migration status values include:

  • NotStarted: Migration has not yet begun
  • InProgress: Migration is currently running
  • Completed: Migration has finished successfully