Retrieving SharePoint Site URL for Teams Channels
Retrieving SharePoint Site URL for Teams Channels
Have you ever needed to construct the SharePoint site URL for a private or shared channel using just the channel name? This post will guide you through the process.
Private Channels
The default SharePoint URL for a private channel follows the format: <ParentSharePointSiteUrl><ChannelRelativeUrl>. Note that if the channel is renamed, the corresponding SharePoint URL remains unchanged.
Shared Channels
Similarly, the default SharePoint URL for a shared channel follows the format: <ParentM365GroupName><ChannelRelativeUrl>. Again, renaming the channel does not alter the SharePoint URL.
At times, you may need to access the underlying SharePoint object representing the Channel folder in SharePoint for specific operations. You can retrieve the SharePoint URL of the channel by querying the Graph API at beta/teams/$m365GroupId/channels/$($channel.Id).
PowerShell Script to Retrieve All Teams Channel SharePoint Site URLs Linked to M365 Connected Teams Site
$m365SiteUrl = "https://contoso.sharepoint.com/sites/test"
Connect-PnPOnline -url $url -interactive
$m365GroupId = (get-pnpsite -include RelatedGroupId).RelatedGroupId.Guid
$RestMethodUrl = "beta/teams/$m365GroupId/channels"
$channels = (Invoke-PnPGraphMethod -Url $RestMethodUrl -Method Get -ConsistencyLevelEventual).value
$channels | ForEach-Object {
write-host ($_.filesfolderweburl).split("Shared Documents")[0]
}
PowerShell Script to Retrieve SharePoint Site URL for a Specific Teams Channel
function get-channelsiteurl ($m365GroupId, $channelName){
$channel= get-pnpteamschannel -team $m365GroupId -Identity $channelName
$RestMethodUrl = "beta/teams/$m365GroupId/channels/$($channel.Id)"
$channel = Invoke-PnPGraphMethod -Url $RestMethodUrl -Method Get -ConsistencyLevelEventual
return ($channel.filesfolderweburl).split("Shared Documents")[0]
}
$url = "https://contoso.sharepoint.com/teams/d-TEAM-DemoTeam"
Connect-PnPOnline -url $url -interactive
$m365GroupId = (get-pnpsite -include RelatedGroupId).RelatedGroupId.Guid
get-channelsiteurl $m365GroupId "Ash-Test"
Conclusion
The Graph API can be used to access Teams Channels and SharePoint folders. Regardless of whether the channel has been renamed or is a private channel, you can always retrieve the URL to the folder in SharePoint using the endpoint beta/teams/$m365GroupId/channels/$($channel.Id).