BREAKING: Rename module (#4)

README.md

@@ -1,19 +1,32 @@
-# Import-TeamsUsers
+# TeamsUserEnroller
-A Powershell script that imports users from a CSV into a Microsoft Teams team.
+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 this module by running `Install-Module -Name TeamsUsersEnroller`. 
-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. 
 
 # 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. Create a CSV file containing your users and their desired roles. The first line must be the headers `email,role`, for example:
-1. Open PowerShell and run `Import-TeamsUsers -File <FILE>`, where `<FILE>` is the full path to the CSV file.
+   ```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).
+If you need assistance, please try the following:
-
+1. See the help documentation by running `Get-Help Import-TeamsUsers`.
-# Issues? Want a new feature?
+1. Check closed issues [here](https://github.com/luketainton/Import-TeamsUsers/issues?q=is%3Aissue+sort%3Aupdated-desc+is%3Aclosed).
-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!
+1. Open an issue [here](https://github.com/luketainton/Import-TeamsUsers/issues/new).

TeamsUserEnroller.psd1

@@ -1,9 +1,9 @@
 #
-# Module manifest for module 'Import-TeamsUsers'
+# Module manifest for module 'TeamsUserEnroller'
 #
 # Generated by: Luke Tainton
 #
-# Generated on: 18/04/2020
+# Generated on: 21/04/2020
 #
 
 @{
@@ -12,13 +12,13 @@
 # RootModule = ''
 
 # Version number of this module.
-ModuleVersion = '1.1.0'
+ModuleVersion = '2.0.0'
 
 # Supported PSEditions
 # CompatiblePSEditions = @()
 
 # ID used to uniquely identify this module
-GUID = '8630e592-818c-46d5-b9cc-d94689ff02af'
+GUID = 'a7b4e6d0-c92e-40df-a238-2b7a131a13a1'
 
 # Author of this module
 Author = 'Luke Tainton'
@@ -27,10 +27,10 @@ Author = 'Luke Tainton'
 CompanyName = 'Luke Tainton'
 
 # Copyright statement for this module
-Copyright = '(c) Luke Tainton. All rights reserved.'
+Copyright = '(c) 2020 Luke Tainton. All rights reserved.'
 
 # Description of the functionality provided by this module
-Description = 'A Powershell function that will enrol users from a CSV file into a given Microsoft Teams group.'
+Description = 'A Powershell module that will enrol users from a CSV file into a given Microsoft Teams group.'
 
 # Minimum version of the PowerShell engine required by this module
 # PowerShellVersion = ''
@@ -66,7 +66,7 @@ RequiredModules = @('MicrosoftTeams')
 # FormatsToProcess = @()
 
 # Modules to import as nested modules of the module specified in RootModule/ModuleToProcess
-NestedModules = @('./Import-TeamsUsers.psm1')
+NestedModules = @('./TeamsUserEnroller.psm1')
 
 # Functions to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no functions to export.
 FunctionsToExport = @('Import-TeamsUsers')
@@ -87,7 +87,7 @@ AliasesToExport = '*'
 # ModuleList = @()
 
 # List of all files packaged with this module
-FileList = @('./Import-TeamsUsers.psm1')
+FileList = @('./TeamsUserEnroller.psm1')
 
 # Private data to pass to the module specified in RootModule/ModuleToProcess. This may also contain a PSData hashtable with additional module metadata used by PowerShell.
 PrivateData = @{
@@ -101,13 +101,13 @@ PrivateData = @{
         # LicenseUri = ''
 
         # A URL to the main website for this project.
-        ProjectUri = 'https://github.com/luketainton/Import-TeamsUsers'
+        ProjectUri = 'https://github.com/luketainton/TeamsUserEnroller'
 
         # A URL to an icon representing this module.
         # IconUri = ''
 
         # ReleaseNotes of this module
-        ReleaseNotes = 'https://github.com/luketainton/Import-TeamsUsers/releases'
+        ReleaseNotes = 'https://github.com/luketainton/TeamsUserEnroller/releases'
 
         # Prerelease string of this module
         # Prerelease = ''

TeamsUserEnroller.psm1

@@ -6,7 +6,6 @@ Function Import-TeamsUsers {
 
     .DESCRIPTION
     Import-TeamsUsers is a Powershell function that will enrol users from a CSV file into a given Microsoft Teams group.
-    It has one required parameter: -File. 
 
     .PARAMETER File
     The path to the CSV file that contains your users. Can either be an absolute path or relative path.

template.csv

@@ -1,3 +0,0 @@
-email,role
-Test.Owner@example.com,owner
-Test.Member@example.com,member