Edit

Share via

Add-TeamUser

  • Reference
Module:
MicrosoftTeamsPowerShell

The Add-TeamUser adds an owner or member to the team, and to the unified group which backs the team.

Syntax

Add-TeamUser
   -GroupId <String>
   -User <String>
   [-Role <String>]
   [<CommonParameters>]

Description

This cmdlet adds an owner or member to the team, and to the unified group which backs the team.

Note

The command will return immediately, but the Teams application will not reflect the update immediately. The change can take between 24 and 48 hours to appear within the Teams client.

Examples

Example 1

Add-TeamUser -GroupId 31f1ff6c-d48c-4f8a-b2e1-abca7fd399df -User dmx@example.com

This example adds the user "dmx@example.com" to a group with the id "31f1ff6c-d48c-4f8a-b2e1-abca7fd399df".

Parameters

-GroupId

GroupId of the team.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Role

Member or Owner. If Owner is specified then the user is also added as a member to the Team backed by unified group.

Type:String
Position:Named
Default value:Member
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-User

UPN of a user of the organization (user principal name - e.g. johndoe@example.com).

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Inputs

GroupId, User, Role