Luke Tainton
dfa4207cb3
* Actually write it as a function Signed-off-by: Luke Tainton <luke@tainton.uk> * Fix readme headers
25 lines
2.0 KiB
Markdown
25 lines
2.0 KiB
Markdown
# 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](https://github.com/PowerShell/PowerShell/releases). 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](mailto:luke@tainton.uk?subject=I%20need%20help%20running%20Import-TeamsUsers).
|
|
|
|
# Issues? Want a new feature?
|
|
If you're having problems with the script or have an idea for a new feature, please check [here](https://github.com/luketainton/Import-TeamsUsers/issues) 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!
|