Add Members to Microsoft Teams | Quick Guide

Streamline Microsoft Teams Management with the New-MgTeamMember Cmdlet

Microsoft 365 administrators seeking efficient team membership management now have a powerful tool at their disposal. The New-MgTeamMember cmdlet, leveraging Microsoft Graph PowerShell, automates the process of adding users to Microsoft Teams – whether individually, in bulk, or via CSV import – significantly reducing manual effort and potential errors.

Managing team memberships efficiently is a core part of Microsoft 365 administration, and this cmdlet offers a faster, scriptable alternative to the Teams Admin Center. Let’s explore how this functionality works and how it can streamline your team management workflows.

What is the New-MgTeamMember Cmdlet?

The New-MgTeamMember cmdlet is a component of the Microsoft Graph PowerShell module designed to add members or owners to a Microsoft Team. It directly interacts with the Microsoft Graph API, utilizing Azure AD user IDs to facilitate additions. Crucially, administrators can assign roles – such as “owner” or “member” – during the addition process, making it an essential tool for automating team management at scale.

In simple terms, one analyst noted, it’s the Graph PowerShell equivalent of adding members through the Teams Admin Center, but with increased speed and scriptability.

Why Use the New-MgTeamMember Cmdlet?

Several key benefits drive administrators and IT professionals to adopt the New-MgTeamMember cmdlet:

• Automation: Add users or entire groups to Teams without the need for manual clicks.
• Scalability: Handle numerous team membership updates with a single, concise script.
• Consistency: Ensure accurate role assignments (owner/member) every time, minimizing discrepancies.
• Integration: Seamlessly combine with CSV imports or directory queries for dynamic and automated updates.

This cmdlet is particularly valuable for organizations of considerable size or those that frequently onboard users into project-based Teams.

How to Use New-MgTeamMember

The fundamental syntax of the cmdlet is as follows:

powershell
New-MgTeamMember -TeamId -BodyParameter

Let’s break down the parameters:

• TeamId: This represents the unique identifier (GUID) of the Microsoft Team to which you intend to add members.
• BodyParameter: This is a hashtable defining the user’s properties, role, and Graph reference using the @odata.bind format.

The BodyParameter is where you specify whether the user should be added as a member or an owner.

New-MgTeamMember Examples

Here are three practical examples demonstrating the cmdlet’s capabilities, ranging from adding a single user to importing members from a CSV file.

Adding a Single User to a Team

powershell
$params = @{
“@odata.type” = “#microsoft.graph.aadUserConversationMember”
roles = @(“owner”)
“[email protected]” = “https://graph.microsoft.com/v1.0/users(‘8b081ef6-4792-4def-b2c9-c363a1bf41d5‘)”
}
New-MgTeamMember -TeamId “72a1f6b2-5829-4f26-b3a4-738b4848e248” -BodyParameter $params

This command adds a single user (identified by the User ID) to the specified team and assigns them the owner role. To add the user as a member instead, simply replace roles = @("owner") with roles = @().

Adding Multiple Users to a Team

powershell
$teamId = “72a1f6b2-5829-4f26-b3a4-738b4848e248”
$members = @(
@{
“@odata.type” = “#microsoft.graph.aadUserConversationMember”
roles = @(“owner”)
“[email protected]” = “https://graph.microsoft.com/v1.0/users(‘8b081ef6-4792-4def-b2c9-c363a1bf41d5‘)”
}
@{
“@odata.type” = “#microsoft.graph.aadUserConversationMember”
roles = @()
“[email protected]” = “https://graph.microsoft.com/v1.0/users(‘9f0e769d-8df1-44f8-bc17-dc7f8881d546‘)”
}
)
foreach ($member in $members) {
New-MgTeamMember -TeamId $teamId -BodyParameter $member
}

This script iterates through multiple user records, adding one as an owner and the other as a member. It’s particularly useful when assigning different roles to multiple users simultaneously.

Adding Users to a Team from a CSV File

For frequent bulk additions, utilizing a CSV file is the most efficient approach. The required CSV structure is:

UserId,Role
8b081ef6-4792-4def-b2c9-c363a1bf41d5,owner
9f0e769d-8df1-44f8-bc17-dc7f8881d546,member

Here’s the corresponding PowerShell script:

powershell
$teamId = “72a1f6b2-5829-4f26-b3a4-738b4848e248”
$csvPath = “C:pathtoyourfile.csv”
$users = Import-Csv -Path $csvPath

foreach ($user in $users) {
$params = @{
“@odata.type” = “#microsoft.graph.aadUserConversationMember”
roles = @($user.Role)
“[email protected]” = “https://graph.microsoft.com/v1.0/users(‘$($user.UserId)’)”
}
New-MgTeamMember -TeamId $teamId -BodyParameter $params
}

This script reads user data from the CSV file and automatically adds each user to the team with the specified role, making it ideal for large-scale onboarding scenarios.

Conclusion

The New-MgTeamMember cmdlet is a powerful tool for automating Microsoft Teams member management. Whether you’re adding a single user, multiple users, or importing from a CSV file, it provides the flexibility, speed, and accuracy needed to manage Teams membership effectively.

✅ Simplify member onboarding
✅ Assign roles programmatically
✅ Reduce manual work and errors

With just a few lines of PowerShell, you can manage Teams memberships at scale – making this cmdlet a must-have for any Microsoft 365 administrator.