# TeamsUserEnroller
A Powershell module that imports users from a CSV into a Microsoft Teams group.

# Setting up your device
This module uses PowerShell, which is pre-installed on Windows. If you're not on Windows, please [download **PowerShell Core**](https://github.com/PowerShell/PowerShell/releases).
1. Open PowerShell as an administrator.
1. Install this module by running `Install-Module -Name TeamsUserEnroller`. 

# Running the script
1. Create a CSV file containing your users and their desired roles. The first line must be the headers `email,role`, for example:
   ```csv
   email,role
   jbloggs@example.com,owner
   user@example.com,member
   ```
1. Run `Import-TeamsUsers -File <FILE>`, where `<FILE>` is the path to the CSV file. You can add the `-Create` flag if you want to create a new team first.

### If you can't run non-signed scripts
If your policy requires scripts to be digitally signed, run

  ```powershell
  Set-ExecutionPolicy Bypass -Scope Process
  ```
  then try running the command again. You may require administrative rights to change the Execution Policy.

# Need help?
If you need assistance, please try the following:
1. See the help documentation by running `Get-Help Import-TeamsUsers`.
1. Check closed issues [here](https://git.tainton.uk/repos/TeamsUserEnroller/issues?type=all&state=closed).
1. Open an issue [here](https://git.tainton.uk/repos/TeamsUserEnroller/issues/new).