repos/TeamsUserEnroller
6
0
Fork 0
Code Issues Pull Requests Actions Packages Releases 8 Activity

BREAKING: Rename module (#4)

Browse Source
This commit was merged in pull request #4.
This commit is contained in:
Luke Tainton
2020-04-21 19:14:14 +01:00
committed by GitHub
parent 99718ae5aa
commit 412966ec1d
4 changed files with 35 additions and 26 deletions
Download Patch File Download Diff File Expand all files Collapse all files

37
README.md
View File

@@ -1,19 +1,32 @@
# Import-TeamsUsers
A Powershell script that imports users from a CSV into a Microsoft Teams team.
# TeamsUserEnroller
A Powershell module that imports users from a CSV into a Microsoft Teams group.
# Setting up your device
This script runs via PowerShell, which is pre-installed on Windows. If you're not on Windows, please download **PowerShell Core** [here](https://github.com/PowerShell/PowerShell/releases). Once you've got PowerShell:
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. Allow remote scripts to execute by running `Set-ExecutionPolicy RemoteSigned`. If you don't do this, the script won't run.
1. Install the Microsoft Teams module. To do this, run `Install-Module -Name MicrosoftTeams`. Accept any prompts that you are given.
1. Install this module by running `Install-Module -Name Import-TeamsUsers`. Accept any prompts that you are given.
1. Install this module by running `Install-Module -Name TeamsUsersEnroller`.
# Running the script
1. Create a CSV file in the format `email,role`. The first line must be the headers `email,role`. You can copy the template if required.
1. Open PowerShell and run `Import-TeamsUsers -File <FILE>`, where `<FILE>` is the full path to the CSV file.
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.
<details>
<summary>If you can't run non-signed scripts</summary>
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 do change the Execution Policy.
</details>
# 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 4 in _Setting up your device_). 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 has the same problem or suggestion, and open an issue if one doesn't already exist. If you can implement a fix or feature request, please file a pull request!
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://github.com/luketainton/Import-TeamsUsers/issues?q=is%3Aissue+sort%3Aupdated-desc+is%3Aclosed).
1. Open an issue [here](https://github.com/luketainton/Import-TeamsUsers/issues/new).