Import-TeamsUsers

A Powershell script that imports users from a CSV into a Microsoft Teams team.

Setting up your device

This script runs via PowerShell. If you're on Windows, you'll already have this. If not, please download it from the releases page. Once you've got PowerShell:

1. Open PowerShell as an administrator.
2. Allow remote scripts to execute by running Set-ExecutionPolicy RemoteSigned. If you don't do this, the script won't run.
3. Install the Microsoft Teams module. To do this, run Install-Module -Name MicrosoftTeams. Accept any prompts that you are given.

Gathering information

You'll need to do a few things before you can run the script:

1. Have a CSV file with the users you want to add. This needs to be in the format email,role. You can copy the template if required.
2. Get your group ID. Import the MS Teams module (Import-Module -Name MicrosoftTeams) and run Get-Team -User <EMAIL>, substituting <EMAIL> for your Office 365 email address, to list all teams you are a member of.

Running the script

1. Download the repository to your PC.
2. Change directory to where you downloaded the repository and import the Import-TeamsUsers module (Import-Module ./Import-TeamsUsers.psm1).
3. Run Import-TeamsUsers -GroupId <GROUPID> -File <FILE>.

Need help?

If you require assistance running the script, see the help by executing Get-Help Import-TeamsUsers (requires importing the module first - see step 2 above). If you still need help, please send me an email.

Issues? Want a new feature?

If you're having problems with the script or have an idea for a new feature, please check here to see if someone else is having the same problem, and open an issue if one doesn't already exist. If you can implement a fix or feature request, please file a pull request!