diff --git a/teams/teams-ps/MicrosoftTeams/Get-TenantPrivateChannelMigrationStatus.md b/teams/teams-ps/MicrosoftTeams/Get-TenantPrivateChannelMigrationStatus.md new file mode 100644 index 0000000000..a3c10548fb --- /dev/null +++ b/teams/teams-ps/MicrosoftTeams/Get-TenantPrivateChannelMigrationStatus.md @@ -0,0 +1,87 @@ +--- +document type: cmdlet +external help file: Microsoft.Teams.PowerShell.TeamsCmdlets.dll-Help.xml +HelpUri: '' +Locale: en-US +Module Name: MicrosoftTeams +ms.date: 10/10/2025 +PlatyPS schema version: 2024-05-01 +title: Get-TenantPrivateChannelMigrationStatus +--- + +# Get-TenantPrivateChannelMigrationStatus + +## SYNOPSIS + +You use the `Get-TenantPrivateChannelMigrationStatus` cmdlet to check the status of private channel migration for your tenant. + +## SYNTAX + +``` +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](https://techcommunity.microsoft.com/blog/microsoftteamsblog/new-enhancements-in-private-channels-in-microsoft-teams-unlock-their-full-potent/4438767#) + +**Note:** This cmdlet requires tenant administrator permissions to execute. + +## EXAMPLES + +### Example 1 +``` +Get-TenantPrivateChannelMigrationStatus +``` +Example output: +``` +TenantId : 12345678-1234-1234-1234-123456789abc +MigrationStatus : Completed +MigrationStartTimeStamp : 2025-10-09T10:15:00.456Z +MigrationCompletionTimeStamp : 2025-10-09T12:45:00.789Z +``` + +This example retrieves the private channel migration status for the current tenant. + +## PARAMETERS + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). + +## 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 + +## RELATED LINKS +[New enhancements in Private Channels in Microsoft Teams unlock their full potential](https://techcommunity.microsoft.com/blog/microsoftteamsblog/new-enhancements-in-private-channels-in-microsoft-teams-unlock-their-full-potent/4438767) + +[Microsoft Teams PowerShell Overview](https://learn.microsoft.com/powershell/teams/) + +[Get-Team](https://learn.microsoft.com/powershell/module/microsoftteams/get-team) + +[Get-TeamChannel](https://learn.microsoft.com/powershell/module/microsoftteams/get-teamchannel) \ No newline at end of file diff --git a/teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md b/teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md index cd412b4590..1ae5a869e2 100644 --- a/teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md +++ b/teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md @@ -596,6 +596,9 @@ Get the status of a hierarchy upload. ### [Get-TeamUser](Get-TeamUser.md) Returns users of a team. +### [Get-TenantPrivateChannelMigrationStatus](Get-TenantPrivateChannelMigrationStatus.md) +You use the `Get-TenantPrivateChannelMigrationStatus` cmdlet to track the status of the private channel migration. + ### [Grant-CsApplicationAccessPolicy](Grant-CsApplicationAccessPolicy.md) Assigns a per-user application access policy to one or more users.