From 26c61d81c61e861c2884c84bc950f42d3e0e12a9 Mon Sep 17 00:00:00 2001
From: Rohan Bharadwaj <rohanbharadwaj@users.noreply.github.com>
Date: Fri, 10 Oct 2025 13:27:16 -0700
Subject: [PATCH 1/2] Add files via upload

Add Get-TenantPrivateChannelMigrationStatus.md
---
 ...Get-TenantPrivateChannelMigrationStatus.md | 87 +++++++++++++++++++
 1 file changed, 87 insertions(+)
 create mode 100644 teams/teams-ps/MicrosoftTeams/Get-TenantPrivateChannelMigrationStatus.md

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 [<CommonParameters>]
+```
+
+## 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

From 0b9f13d5f51210dd847cb2e69f8efef197cee31f Mon Sep 17 00:00:00 2001
From: Rohan Bharadwaj <rohanbharadwaj@users.noreply.github.com>
Date: Fri, 10 Oct 2025 13:33:28 -0700
Subject: [PATCH 2/2] Add Get-TenantPrivateChannelMigrationStatus section to
 microsoftteams.md

---
 teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md | 3 +++
 1 file changed, 3 insertions(+)

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.