Clear-TeamsCache.ps1

19 Sep 2025

Description
- Purpose
- Detailed Description
- Usage
- Notes
- Script
- Download
- Report Issues

Description

Purpose

Get-UsersTeamsCacheSummary function gets a summary of the space used for each user in the Teams cache.

Detailed Description

The Get-UsersTeamsCacheSummary function retrieves the size of the Teams cache for each user in the C:\Users directory. It calculates the size in megabytes and displays it in the format “Username - Size MB”.

Usage

Example 1

Get-UsersTeamsCacheSummary

This example retrieves the size of the Teams cache for each user in the C:\Users directory and displays it.

Notes

No additional notes.

Script

# Functions and script to clear the Teams cache
# Script will need to close Teams if it is running
# Users Cache: %appdata%\Microsoft\Teams

<#
.SYNOPSIS
    Get-UsersTeamsCacheSummary function gets a summary of the space used for each user in the Teams cache.

.DESCRIPTION
    The Get-UsersTeamsCacheSummary function retrieves the size of the Teams cache for each user in the C:\Users directory. It calculates the size in megabytes and displays it in the format "Username - Size MB".

.EXAMPLE
    Get-UsersTeamsCacheSummary
    This example retrieves the size of the Teams cache for each user in the C:\Users directory and displays it.

#>
function Get-UsersTeamsCacheSummary {
     $users = Get-ChildItem C:\Users | Where-Object { $_.PSIsContainer } | Select-Object -ExpandProperty Name
     foreach ($user in $users) {
          $path = "C:\Users\$user\AppData\Roaming\Microsoft\Teams"
          if (Test-Path $path) {
                $size = (Get-ChildItem -Path $path -Recurse -Force -ErrorAction SilentlyContinue | Measure-Object -Property Length -Sum -ErrorAction SilentlyContinue).Sum
                $size = $size / 1MB
                $size = [math]::Round($size, 2)
                Write-Host "$user - $size MB"
          }
     }
}

<#
.SYNOPSIS
    Get-TeamsCache function gets the Teams cache for all local users.

.DESCRIPTION
    The Get-TeamsCache function retrieves the Teams cache for all local users. It returns the list of files and directories in the Teams cache directory.

.EXAMPLE
    Get-TeamsCache
    This example retrieves the Teams cache for all local users.

#>
function Get-TeamsCache {
     $path = "$env:APPDATA\Microsoft\Teams"
     if (Test-Path $path) {
          Get-ChildItem -Path $path -Recurse -Force -ErrorAction SilentlyContinue
     }
}

<#
.SYNOPSIS
    Clear-TeamsCacheLM function clears the Teams cache for all local users.

.DESCRIPTION
    The Clear-TeamsCacheLM function removes the Teams cache directory for each user in the C:\Users directory.

.EXAMPLE
    Clear-TeamsCacheLM
    This example clears the Teams cache for all local users.

#>
function Clear-TeamsCacheLM {
     $users = Get-ChildItem C:\Users | Where-Object { $_.PSIsContainer } | Select-Object -ExpandProperty Name
     foreach ($user in $users) {
          $path = "C:\Users\$user\AppData\Roaming\Microsoft\Teams"
          if (Test-Path $path) {
                Remove-Item -Path $path -Recurse -Force -ErrorAction SilentlyContinue
          }
     }
}

<#
.SYNOPSIS
    Clear-TeamsCacheCU function clears the Teams cache for the current user.

.DESCRIPTION
    The Clear-TeamsCacheCU function removes the Teams cache directory for the current user.

.EXAMPLE
    Clear-TeamsCacheCU
    This example clears the Teams cache for the current user.

#>
function Clear-TeamsCacheCU {
     $path = "$env:APPDATA\Microsoft\Teams"
     if (Test-Path $path) {
          Remove-Item -Path $path -Recurse -Force -ErrorAction SilentlyContinue
     }
}

<#
.SYNOPSIS
    Stop-Teams function checks if Teams is running and closes it if it is.

.DESCRIPTION
    The Stop-Teams function checks if the Teams process is running and forcefully terminates it if it is.

.EXAMPLE
    Stop-Teams
    This example checks if Teams is running and closes it if it is.

#>
function Stop-Teams {
     $TeamsProcess = Get-Process -Name Teams -ErrorAction SilentlyContinue
     if ($TeamsProcess) {
          Stop-Process -Name Teams -Force
     }
}

# Call the function to stop Teams

# Stop-Teams

# Call the function to clear the Teams cache

# Clear-TeamsCacheLM
# Clear-TeamsCacheCU

Download

Please feel free to copy parts of the script or if you would like to download the entire script, simply click the download button. You can download the complete repository in a zip file by clicking the Download link in the menu bar on the left hand side of the page.

Report Issues

You can report an issue or contribute to this site on GitHub. Simply click the button below and add any relevant notes. I will attempt to respond to all issues as soon as possible.

Issue

Maintenance Scripts