Back to script library
Entra / Microsoft 365 · Teams

Teams creation report by email

A script to locate Office 365 audit records for the creation of new Teams and report the fact via email.

Connect & set up

Run these once per session. All scopes are read-only unless the script makes changes.

Connect-ExchangeOnline

Run it

The main script. Copy it, or download the .ps1 and run it from your console.

param(
[int] $LookbackDays = 90,
[string] $StartDate = (Get-Date).AddDays(-$LookbackDays); $EndDate = (Get-Date).AddDays(1),
[string] $EndDate = (Get-Date)
)
#HTML header with styles
$htmlhead="
<style>
BODY{font-family: Arial; font-size: 10pt;}
H1{font-size: 22px;}
H2{font-size: 18px; padding-top: 10px;}
H3{font-size: 16px; padding-top: 8px;}
</style>"
#Header for the message
$HtmlBody = "
<h1>Teams Creation Report for teams created between $(Get-Date($StartDate) -format g) and $(Get-Date($EndDate) -format g)</h1>
<p><strong>Generated:</strong> $(Get-Date -Format g)</p>
<h2><u>Details of Teams Created</u></h2>"
#Person to get the email
$EmailRecipient = "SomeoneinYourTenant@Tenant.com" # &lt;- Update this with the real address
If (-not $O365Cred) { #Make sure we have credentials
$O365Cred = (Get-Credential)}
$MsgFrom = $O365Cred.UserName ; $SmtpServer = "smtp.office365.com" ; $SmtpPort = '587'
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
# Find records for team creation in the Office 365 audit log
Write-Host "Looking for Team Creation Audit Records..."
[array]$Records = Search-UnifiedAuditLog -StartDate $StartDate -EndDate $EndDate -Operations "TeamCreated" -ResultSize -SessionCommand ReturnLargeSet
If ($Records.Count -eq 0) {
Write-Host "No Team Creation records found." }
Else {
Write-Host "Processing" $Records.Count "audit records..."
$Records = $Records | Sort-Object Identity -Unique
$Report = [System.Collections.Generic.List[Object]]::new()
ForEach ($Rec in $Records) {
$AuditData = ConvertFrom-Json $Rec.Auditdata
$O365Group = (Get-UnifiedGroup -Identity $AuditData.TeamName) # Need some Office 365 Group properties
$ReportLine = [PSCustomObject]@{
TimeStamp = Get-Date($AuditData.CreationTime) -format g
User = $AuditData.UserId
Action = $AuditData.Operation
TeamName = $AuditData.TeamName
Privacy = $O365Group.AccessType
Classification = $O365Group.Classification
MemberCount = $O365Group.GroupMemberCount
GuestCount = $O365Group.GroupExternalMemberCount
ManagedBy = $O365Group.ManagedBy
}
$Report.Add($ReportLine) }
}
# Add details of each team
$Report | Sort-Object TeamName -Unique | ForEach {
$htmlHeaderTeam = "<h2>" + $_.TeamName + "</h2>"
$htmlline1 = "<p>Created on <b>" + $_.TimeStamp + "</b> by: " + $_.User + "</p>"
$htmlline2 = "<p>Privacy: <b>" + $_.Privacy + "</b> Classification: <b>" + $_.Classification + "</b></p>"
$htmlline3 = "<p>Member count: <b>" + $_.MemberCount + "</b> Guest members: <b>" + $_.GuestCount + "</b></p>"
$htmlbody = $htmlbody + $htmlheaderTeam + $htmlline1 + $htmlline2 + $htmlline3 + "<p>"
}
# Finish up the HTML message body
$HtmlMsg = "" + $HtmlHead + $HtmlBody
# Construct the message parameters and send it off...
$MsgParam = @{
To = $EmailRecipient
From = $MsgFrom
Subject = "Teams Creation Report"
Body = $HtmlMsg
SmtpServer = $SmtpServer
Port = $SmtpPort
Credential = $O365Cred}
Send-MailMessage @msgParam -UseSSL -BodyAsHTML ; Write-Host "Teams Creation Report sent by email to" $EmailRecipient

Parameters

ParameterDefaultNotes
-LookbackDays90How many days back to search audit records for new Teams.
-StartDate(Get-Date).AddDays(-90)Start of the audit search window.
-EndDate(Get-Date).AddDays(1)End of the audit search window.
Attribution