Remove-TeamUser

Note: This cmdlet is currently in Beta.

Remove an owner or member from a team, and from the unified group which backs the team.

Note: the command will return immediately, but the Teams application will not reflect the update immediately. The Teams application may need to be open for up to an hour before changes are reflected.

Note: last owner cannot be removed from the team.

Syntax

Remove-TeamUser
      -GroupId <String>
      -User <String>
      -Role <String>

Examples

-------------------------- Example 1 --------------------------

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

Required Parameters

-GroupId

GroupId of the team

Type:String
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
Applies to:Microsoft Teams
-User

User's UPN (user principal name - e.g. johndoe@example.com)

Type:String
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
Applies to:Microsoft Teams

Optional Parameters

-Role

Use this to demote a user from owner to member of the team

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams