BREAKING: Rename module (#4)

2020-04-21 19:14:14 +01:00
parent 99718ae5aa
commit 412966ec1d
4 changed files with 35 additions and 26 deletions
--- a/TeamsUserEnroller.psm1
+++ b/TeamsUserEnroller.psm1
@@ -0,0 +1,84 @@
+Function Import-TeamsUsers {
+
+<#
+    .SYNOPSIS
+    Import-TeamsUsers is a Powershell function that will enrol users from a CSV file into a given Microsoft Teams group.
+
+    .DESCRIPTION
+    Import-TeamsUsers is a Powershell function that will enrol users from a CSV file into a given Microsoft Teams group.
+
+    .PARAMETER File
+    The path to the CSV file that contains your users. Can either be an absolute path or relative path.
+
+    .EXAMPLE
+    Import-TeamsUsers -File "users.csv"
+#>
+
+    Param(
+        [parameter(Mandatory=$true, position=1, ParameterSetName='Params', HelpMessage="Specify CSV file")]
+        [string]$File
+    )
+
+    Begin {
+        $ErrorActionPreference = 'Stop'
+        ##### IMPORT CSV FILE #####
+        $Users = Import-CSV $File
+
+        ##### CHECK MODULE IS INSTALLED AND IMPORTED #####
+        if (Get-Module -ListAvailable -Name MicrosoftTeams) {
+            Import-Module -Name MicrosoftTeams
+            $Email = (Connect-MicrosoftTeams -Verbose:$false).Account
+        } else {
+            Write-Host -ForegroundColor Red "Module MicrosoftTeams doesn't exist. Please run 'Install-Module -Name MicrosoftTeams' and retry."
+            Exit
+        }
+    }
+
+    Process {
+        ##### GET USER'S TEAMS #####
+        Clear-Host
+        Write-Host -ForegroundColor Green "Getting your teams - please wait"
+        $EligibleTeams = @()
+        Get-Team -User $Email -Verbose:$false | ForEach-Object {
+            $CTeamId = $_.GroupId
+            $CTeamName = $_.DisplayName
+            If (Get-TeamUser -GroupId $CTeamId | Select-Object -Property User,Role | Where-Object {$_.User -eq $Email} | Where-Object {$_.Role -eq "owner"}) {
+                $EligibleTeams += @{GroupId = $CTeamId; DisplayName = $CTeamName}
+            }
+            Clear-Variable -Name CTeamId
+            Clear-Variable -Name CTeamName
+        }
+        Clear-Host
+        Write-Host "Teams that you own:"
+        $EligibleTeams | ForEach-Object {[PSCustomObject]$_} | Format-Table 'GroupId', 'DisplayName' -AutoSize
+        $GroupId = Read-Host -Prompt "GroupId of the desired group"
+
+        ##### ENROL USERS #####
+        $global:UsersAdded = 0;
+        $UserCount = $Users | Measure-Object | Select-Object -expand count
+        $Consent = Read-Host -Prompt "You are about to add $UserCount users. Are you sure? [y/N]"
+        If ($Consent -eq "y" -Or $Consent -eq "Y") {
+            $Users | ForEach-Object {
+                $User = $_.email
+                $Role = $_.role
+                Try {
+                    Add-TeamUser -GroupId $GroupId -Role $Role -User $User
+                    Write-Host "Added user $User with role $Role"
+                    $global:UsersAdded++
+                } Catch [Microsoft.TeamsCmdlets.PowerShell.Custom.ErrorHandling.ApiException] {
+                    Write-Host -ForegroundColor Red "Error adding user $User with role $Role"
+                }
+                Clear-Variable -Name User
+                Clear-Variable -Name Role
+            }
+            Write-Host -ForegroundColor Green "$global:UsersAdded users added successfully."
+        } Else {
+            Write-Host -ForegroundColor Red "Aborting."
+        }
+    }
+    
+    End {
+        @('UserCount', 'UsersAdded', 'Consent', 'Users', 'GroupId') | ForEach-Object {Clear-Variable -Name $_}
+        Disconnect-MicrosoftTeams
+    }
+}