TeamsUserEnroller.psm1
|
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 } } |