Get-MgTeamMember

What is Get-MgTeamMember?

The Get-MgTeamMember cmdlet in Microsoft Graph PowerShell retrieves the members of a specific Microsoft Team, including owners, members, and guests. It provides administrators with visibility into team memberships, which can be expanded to include detailed user information by combining it with the Get-MgUser cmdlet.

Why Use Get-MgTeamMember?

Managing Teams memberships at scale can be challenging, especially in large organizations. The Get-MgTeamMember cmdlet allows administrators to:

• Audit Teams memberships to ensure compliance and proper access control.
• Identify inactive or missing members for cleanup operations.
• Automate team reporting by exporting member details.
• Combine with Get-MgUser for rich profile data retrieval (name, UPN, roles, etc.).

It’s an essential cmdlet for Microsoft 365 automation and governance.

Prerequisites

Before using this cmdlet, connect to Microsoft Graph with the required permissions:

Connect-MgGraph -Scopes "TeamMember.Read.All"

You must also have appropriate access rights to view membership information in the specified Team.

How to Use Get-MgTeamMember?

The basic syntax is simple — you specify the Team ID to fetch its members:

Get-MgTeamMember -TeamId <team-id>

By default, this cmdlet returns only the Team member IDs. To get user details (like Display Name or UPN), you need to pass the output to Get-MgUser.

Get-MgTeamMember Examples

Example 1: Fetch Team Member IDs

This example retrieves all members (owners and users) of a specific Microsoft Team.

Get-MgTeamMember -TeamId <team-id>

This command lists the user IDs of all members in the specified Team.

Example 2: Fetch Team Member Details

Note: By default, the Get-MgTeamMember cmdlet only returns member IDs. To view user details, pass the results to the Get-MgUser cmdlet.

$teamId = "9f47ec97-db44-41db-8867-3793cff0a49a"
# Get all team members
$teamMembers = Get-MgTeamMember -TeamId $teamId -All
# Retrieve detailed information for each team member
$teamMemberDetails = foreach ($member in $teamMembers) {
    $additionalProps = $member.AdditionalProperties
    $userId = $additionalProps["userId"]
    if ($userId -ne $null -and $userId -ne "") {
        $user = Get-MgUser -UserId $userId
        [PSCustomObject]@{
            Id = $user.Id
            DisplayName = $user.DisplayName
            UserPrincipalName = $user.UserPrincipalName
        }
    }
}

# Display the team member details
$teamMemberDetails | Format-Table -AutoSize

This example fetches all members from a specified Team and retrieves detailed user information for each member such as Display Name and UserPrincipalName.

Summary

Key Point	Details
Cmdlet Name	Get-MgTeamMember
Purpose	Retrieves members of a Microsoft Team
Required Scope	TeamMember.Read.All
Primary Parameter	TeamId
Automation Benefit	Enables administrators to automate membership audits and reporting
Use Case	Identifying, exporting, or verifying Microsoft Teams memberships