https://github.com/smalls1652/smallsonline.teamsattendance
Last ditch option for retrieving Teams meeting attendance reports.
https://github.com/smalls1652/smallsonline.teamsattendance
csharp microsoft-teams powershell
Last synced: about 2 months ago
JSON representation
Last ditch option for retrieving Teams meeting attendance reports.
- Host: GitHub
- URL: https://github.com/smalls1652/smallsonline.teamsattendance
- Owner: Smalls1652
- License: mit
- Created: 2023-06-29T18:22:15.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2023-06-30T20:12:37.000Z (almost 2 years ago)
- Last Synced: 2025-04-04T13:12:50.097Z (2 months ago)
- Topics: csharp, microsoft-teams, powershell
- Language: PowerShell
- Homepage:
- Size: 48.8 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Teams Attendance Reports
You may be asking yourself... Can't you already get attendance reports natively through Teams? [Yes. Yes you can.](https://support.microsoft.com/en-us/office/manage-meeting-attendance-reports-in-teams-ae7cf170-530c-47d3-84c1-3aedac74d310) So what's the point of this? Well... There are unique use cases and is meant to be a **last ditch option**. In my case:
* It's been well past the meeting dates and the attendance reports are no longer available to download.
* The data in the attendance report that's available isn't showing the whole meeting because the meeting had a new session of the meeting start.
* The instructor may have forgotten to get the attendance report and they're not around, at the time, when it needs to be submitted for audit/accreditation reasons.
## 🪄 How does it work?
It's _best guess_ and it doesn't correlate a meeting to a specific class; however, it can get **all** of the meetings a user organized and get their respective attendees with their join and leave times.
It utilizes `Search-UnifiedAuditLog` in the `ExchangeOnlineManagement` PowerShell module to get all `MeetingDetail` and `MeetingParticipantDetail` entries from your tenant's [Microsoft 365 Unified Audit Log](https://learn.microsoft.com/en-us/microsoft-365/compliance/audit-log-search?view=o365-worldwide)... Provided you have [the necessary license to use it](https://learn.microsoft.com/en-us/microsoft-365/compliance/audit-solutions-overview?view=o365-worldwide#audit-standard-1) and your user account has the [correct permissions to search the audit log](https://learn.microsoft.com/en-us/microsoft-365/compliance/audit-standard-setup?view=o365-worldwide#step-2-assign-permissions-to-search-the-audit-log).
## 📋 Requirements
* [PowerShell 7.3](https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell?view=powershell-7.3)
* That means no Windows PowerShell 5.1 support.
* [`ExchangeOnlineManagement` v3.2.0 and higher](https://www.powershellgallery.com/packages/ExchangeOnlineManagement/3.2.0)
* [`Microsoft.Graph` v1.2.8 and higher](https://www.powershellgallery.com/packages/Microsoft.Graph/1.28.0)
* I have **not** tested this against the preview/release candidate releases of the upcoming v2.0.0 release.
* If you don't want to install the meta module, v1.2.8 of [`Microsoft.Graph.Authentication`](https://www.powershellgallery.com/packages/Microsoft.Graph.Authentication/1.28.0) and [`Microsoft.Graph.Users`](https://www.powershellgallery.com/packages/Microsoft.Graph.Users/1.28.0) are the exact requirements.
* [`ImportExcel` v7.8.5 or higher](https://www.powershellgallery.com/packages/ImportExcel/7.8.5)
To install those required modules you can run these commands, depending on the version of `PowerShellGet` you're using:
```powershell
# PowerShellGet v2 (Default)
Install-Module -Name "ExchangeOnlineManagement" -MinimumVersion "3.2.0"
Install-Module -Name "Microsoft.Graph" -MinimumVersion "1.2.8" -MaximumVersion "2.99"
Install-Module -Name "ExchangeOnlineManagement" -MinimumVersion "7.8.5"
```
```powershell
# PowerShellGet v3 / PSResourceGet
Install-PSResource -Name "ExchangeOnlineManagement" -Version "3.2.0"
Install-PSResource -Name "Microsoft.Graph" -Version "1.2.8"
Install-PSResource -Name "ExchangeOnlineManagement" -Version "7.8.5"
```
## ⬇️ Installing
### PowerShell Gallery
The module is available here [on PowerShell Gallery](https://www.powershellgallery.com/packages/SmallsOnline.TeamsAttendance.Pwsh).
Installing it from PowerShell Gallery will depend on which version of the `PowerShellGet` version you're using.
#### `PowerShellGet` v2 (Default)
```powershell
Install-Module -Name "SmallsOnline.TeamsAttendance.Pwsh"
```
#### `PowerShellGet` v3 / `PSResourceGet`
```powershell
Install-PSResource -Name "SmallsOnline.TeamsAttendance.Pwsh"
```
### Manually
Download the ZIP artifact from [the latest release](https://github.com/Smalls1652/SmallsOnline.TeamsAttendance/releases/latest), extract it, and import it using `Import-Module`.
## 🧑💻 Building from source
In addition to the requirements listed in [the requirements section](#-requirements), these need to be installed on your system:
- [.NET 7 (or higher) SDK](https://dotnet.microsoft.com/en-us/download/dotnet/7.0)
- [`PlatyPS` v0.14.2](https://www.powershellgallery.com/packages/platyPS/0.14.2)
After cloning this repository with `git`, open up a terminal prompt (`bash`, `zsh`, `pwsh`, etc.) and navigate to the cloned directory. Run the following command to build the module:
```
dotnet msbuild SmallsOnline.TeamsAttendance.proj -target:"BuildPowerShellModule"
```
The compiled module will be located in `./build/` once it is finished.
## 🤝 License
This project is licensed under the [MIT License](./LICENSE).