script to use PowerShell to Report Teams Status, Presence and Reset After Time

Install Teams PowerShell Module First, install and import the Teams PowerShell module:

Install-Module -Name PowerShellGet -Force -AllowClobber
Install-Module -Name MicrosoftTeams
Import-Module MicrosoftTeams

Connect to Microsoft Teams You need to authenticate to Microsoft Teams using your tenant credentials:

$credential = Get-Credential
Connect-MicrosoftTeams -Credential $credential

Retrieve Users' Presence Status To retrieve users' presence status, we can use Get-TeamUserPresence (from the Teams module). Here’s a basic command:

$users = Get-TeamUserPresence
foreach ($user in $users) {
    Write-Host "$($user.User) - $($user.Presence)"
}

Report and Reset Teams Presence Unfortunately, there is no direct command to "reset" presence status from the Teams PowerShell module. You can manually set the presence by using Teams client-side features or Microsoft Graph API.

For demonstration purposes, we can set a simple logic to report the user presence status for users who have been idle for a period, then take an action based on that (e.g., resetting status by updating the Presence).

# Ensure Teams PowerShell Module is installed
Install-Module -Name MicrosoftTeams -Force -AllowClobber
Import-Module MicrosoftTeams

# Connect to Microsoft Teams
$credential = Get-Credential
Connect-MicrosoftTeams -Credential $credential

# Function to get presence status for all users in the tenant
Function Get-TeamsPresence {
    $users = Get-TeamUserPresence
    $results = @()

    foreach ($user in $users) {
        # Output user presence status and the time they were last active
        $userStatus = New-Object PSObject -property @{
            UserName    = $user.User
            Presence    = $user.Presence
            LastActivityTime = $user.LastActivityTime
        }
        $results += $userStatus
    }
    
    return $results
}

# Function to report presence
Function Report-UserPresence {
    $results = Get-TeamsPresence
    $currentTime = Get-Date

    foreach ($user in $results) {
        $timeDiff = $currentTime - $user.LastActivityTime
        if ($timeDiff.TotalMinutes -gt 60) {  # If more than 60 minutes idle
            Write-Host "User $($user.UserName) has been idle for $([math]::Round($timeDiff.TotalMinutes, 2)) minutes."
            # Action to reset presence could be added here with Microsoft Graph API if available
            # Example: Update presence using Microsoft Graph API (if such an endpoint is available)
            # ResetTeamsPresence($user.UserName)
        } else {
            Write-Host "$($user.UserName) - Current Status: $($user.Presence) - Last Active: $($user.LastActivityTime)"
        }
    }
}

# Call function to report status and reset after time
Report-UserPresence

# To automate resetting the status after a specific time
# You would need to use Microsoft Graph API (Presence API) or set up a flow in Power Automate if needed

Thank you for the replies. However, this doesnt get to the bit I require. I am looking to find the "Reset Status After" field, as I showed in the print screen above. I cant seem to find how to access that data. I'm sure its hidden in the near vacinity of where you show, but I just cant extract it.