Everyone is talking about Microsoft Teams at this time. Me too. So I decided to focus more and more on this cloud technology, in particular the automation of it. In this blog post I will show you how you can get a list of all your teams, team members and team channels of your tenant at once to get a perfect overview of your environment. Let’s slip into it.
The Objective
We want to see this screen. A nice overwiew of all teams, team users and team channels.
The Code
Copy the code below into PowerShell ISE or Visual Studio Code and run it. The code will detect whether the MSTeams Module is installed. If it is not installed, the script will install the right module for you.
<#
.SYNOPSIS
Lists all Microsoft Teams by name, team members and team channels.
.DESCRIPTION
Copy this code into an editor or your choosing
(recommended: PowerShell ISE or VS Code)
.NOTES
Author: Patrick Gruenauer | Microsoft MVP PowerShell
Web: https://sid-500.com
#>
# Check if Teams Module is installed. If not, it will be installed
If (-not (Get-Module -ListAvailable | Where-Object Name -eq 'MicrosoftTeams' ))
{
Install-Module -Name MicrosoftTeams -Force -AllowClobber
}
# Connect to Microsoft Teams
Connect-MicrosoftTeams
# List all Teams and all Channels
$ErrorAction = "SilentlyContinue"
$allteams = Get-Team
$object = @()
foreach ($t in $allteams) {
$members = Get-TeamUser -GroupId $t.GroupId
$owner = Get-TeamUser -GroupId $t.GroupId -Role Owner
$channels = Get-TeamChannel -GroupId $t.GroupId
$object += New-Object -TypeName PSObject -Property ([ordered]@{
'Team'= $t.DisplayName
'GroupId' = $t.GroupId
'Owner' = $owner.User
'Members' = $members.user -join "`r`n"
'Channels' = $channels.displayname -join "`r`n"
})
}
Write-Output $object
That’s it for today. Thank you for reading this article.
See also
How to add a custom menu item in PowerShell ISE
When I read the excellent book “Office 365” by Markus Widl, I was surprised that the author covered so many PowerShell topics. Great book! Especially one topic in his book is interesting. Adding menu items in PowerShell ISE to connect to your Office 365 tenant. Shame on me, I didn’t know this could be done. […]
PowerShell: $null vs ::IsNullOrEmpty
Null is null. Dividing by zero is not allowed, say the mathematicians. What about null in PowerShell? Is null equal empty? What is $null? Why a method IsNullOrEmpty? In this blog post I will shed some on this and provide you with some examples to understand the differences between null and null or empty.
PowerShell: Manipulating Strings with Trim, TrimStart and TrimEnd
In PowerShell it’s easy to manipulate strings, especially to cut off some characters from a string. These three methods are your friends when it comes to trimming: Trim, TrimStart and TrimEnd. In this blog post I will show you how to use PowerShell to manipulate strings and cut off something at the beginning and at […]
Categories: Microsoft 365, PowerShell
My name is Patrick Gruenauer. From Austria.
great thanks
just in this part
$object += New-Object -TypeName PSObject -Property ([ordered]@{
i know you managed the “ordered” method
but i obtainied great result without the need of order with this instead.
$object+=[pscustomobject]@{
also another question, if you export to CSV with that format you have is working? have you tried?
LikeLike
Thank you for your feedback. Csv export should be fine.
LikeLike
Learning a great deal from your blogs. Being a newbie using powershell I always tend to look forward to new posts.
I’m struggling with enabling users to Teams enterprise voice and adding them one by one a Number etc. using the SetCSOnline, GrantCSOnline voice routing policy.
LikeLiked by 1 person