M365 PowerShell

Using Get-MgTeamChannelMember in Graph PowerShell

The Get-MgTeamChannelMember cmdlet is a powerful tool for administrators to retrieve details about the members of a specific Microsoft Teams channel. This cmdlet is essential for managing and auditing channel membership within an organization. In this article, we will explore the syntax, usage examples, tips, common errors with solutions, and use cases to help you get the most out of this cmdlet.

Cmdlet Syntax

Get-MgTeamChannelMember -TeamId <String> -ChannelId <String>

TeamId: The unique identifier of the team.
ChannelId: The unique identifier of the channel within the team.
Filter: (Optional) The OData query to filter results.

Usage Examples

Example 1: Get All Channel Members

Get-MgTeamChannelMember -TeamId "d58a6e74-23a5-46db-a13f-b9a5625f9f1a" -ChannelId "19:737f2e5b6c4d4d46905d2f1b4bcf6f34@thread.tacv2"

This example retrieves all members of a specific channel within a team.

Example 2: Filter Channel Members by User Role

Get-MgTeamChannelMember -TeamId "d58a6e74-23a5-46db-a13f-b9a5625f9f1a" -ChannelId "19:737f2e5b6c4d4d46905d2f1b4bcf6f34@thread.tacv2" -Filter "roles/any(r: r eq 'owner')"

In this example, we retrieve all members of a channel who have the role of "owner".

Cmdlet Tips

Use the Filter Parameter for Specific Results: When dealing with large teams or channels, using the -Filter parameter can significantly reduce the amount of data returned and make your query more efficient.
Combine Parameters: You can combine multiple parameters like -ChannelId and -Filter to narrow down your search results further.
Check for Permissions: Ensure that you have the necessary permissions to access the team's channel members, as insufficient permissions can lead to errors. ChannelMember.ReadWrite.All is the required Graph API permission.

Possible Errors & Solutions

Error: ResourceNotFound

Cause: The specified TeamId or ChannelId does not exist, or the user does not have access.

Solution: Verify that the TeamId and ChannelId are correct and that you have the necessary permissions to access the team and channel.

Error: Request_UnsupportedQuery

Cause: The -Filter parameter was used incorrectly or with unsupported query options.

Solution: Review the OData query documentation and ensure that the filter syntax is correct. Common mistakes include incorrect property names or unsupported query operators.

Use Cases

Auditing Channel Membership: Organizations often need to audit channel memberships to ensure that only the right people have access to specific channels. The Get-MgTeamChannelMember cmdlet allows administrators to list all members of a channel and filter by role, ensuring compliance with internal policies.
Automating Reports on Channel Ownership: By filtering results to show only channel owners, administrators can quickly generate reports on channel ownership. This is particularly useful in scenarios where ownership changes need to be monitored or when preparing for transitions between teams.
Security Audits: Regularly retrieving channel member lists can be part of security audits to ensure that sensitive information is only accessible to authorized users. By combining this cmdlet with scripts that check for external users, organizations can safeguard their internal communications.

Conclusion

The Get-MgTeamChannelMember cmdlet is an invaluable tool for managing and auditing Microsoft Teams channels. By understanding its syntax, parameters, and common errors, administrators can efficiently retrieve and filter channel member data, ensuring that team communication is secure and well-managed. Whether you are conducting routine audits or automating membership reports, this cmdlet offers the flexibility and power needed to maintain an organized and secure Teams environment.

If You Prefer the Graph API Way

The /teams/{team-id}/channels/{channel-id}/members endpoint lets you retrieve channel members in a Microsoft Team. You can optionally filter members based on their role (like owner, member, or guest) using client-side filtering in PowerShell.

Example 1: Get All Channel Members

This example retrieves all members of a specific channel.

$teamId    = "d58a6e74-23a5-46db-a13f-b9a5625f9f1a"
$channelId = "19:737f2e5b6c4d4d46905d2f1b4bcf6f34@thread.tacv2"

$uri = "https://graph.microsoft.com/v1.0/teams/$teamId/channels/$channelId/members"

$response = Invoke-MgGraphRequest -Method GET -Uri $uri

foreach ($member in $response.value) {
    Write-Output "User ID : $($member.userId)"
    Write-Output "Roles   : $($member.roles -join ', ')"
    Write-Output "`n"
}

✅ Equivalent to:

Get-MgTeamChannelMember -TeamId "<team-id>"  -ChannelId "<channel-id>"

Example 2: Filter Channel Members by User Role (e.g., Owner)

Since the /members endpoint does not support server-side $filter on roles, we must filter on the client side in PowerShell:

$teamId    = "d58a6e74-23a5-46db-a13f-b9a5625f9f1a"
$channelId = "19:737f2e5b6c4d4d46905d2f1b4bcf6f34@thread.tacv2"

$uri = "https://graph.microsoft.com/v1.0/teams/$teamId/channels/$channelId/members"

$response = Invoke-MgGraphRequest -Method GET -Uri $uri

$owners = $response.value | Where-Object { $_.roles -contains "owner" }

foreach ($owner in $owners) {
    Write-Output "Owner User ID: $($owner.userId)"
}

⚠️ Note: $filter is not supported for roles in this endpoint, so filtering must be performed after retrieving all data.

Required Permissions

Context	Permission
Delegated	`ChannelMember.Read.All`
Application	`ChannelMember.Read.All`

Graph API Documentation

List channel members – /teams/{team-id}/channels/{channel-id}/members
AadUserConversationMember resource type

Additional Resources:

Graph PowerShell Get-MgTeamChannelMember Cmdlet Documentation
Microsoft Graph PowerShell Module Documentation
Microsoft Graph API Documentation

Using Get-MgDirectoryRole in Graph PowerShell
Using Get-MgUserLicenseDetail in Graph PowerShell
Using Find-GraphMgCommand in Graph PowerShell
Connect to Microsoft 365 Using PowerShell
How to Create Bulk Users in Office 365 Using Graph PowerShell?
Create Microsoft 365 Group Using Microsoft Graph PowerShell
Block Microsoft 365 User Using Microsoft Graph PowerShell
Assign Microsoft 365 License Using Graph PowerShell
Microsoft 365 User Management Using Graph PowerShell
Checking Group Membership in Microsoft 365
Bulk Assign Microsoft 365 License
Find Inactive Users in Microsoft 365
Using Powershell Graph Search Query
Using Powershell Graph Filter Query
Using Where-Object In Graph PowerShell
Using Expand Property In Graph PowerShell
Using Select Object In Graph PowerShell
Using -Contains Operator In Graph PowerShell
Add User to Multiple Microsoft 365 Groups Using Graph PowerShell
Get Microsoft 365 User Location Using Graph PowerShell
Import Microsoft 365 Groups from CSV File Using Graph PowerShell
Microsoft 365 Group User Import Using Graph PowerShell