{"id":21182590,"url":"https://github.com/digressive/logon-audit","last_synced_at":"2025-07-10T00:32:35.475Z","repository":{"id":113371556,"uuid":"211530088","full_name":"Digressive/Logon-Audit","owner":"Digressive","description":"Record log on and log off events with this PowerShell script.","archived":false,"fork":false,"pushed_at":"2024-05-14T20:47:55.000Z","size":24,"stargazers_count":8,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-08-13T07:06:40.046Z","etag":null,"topics":["logon-audit","logs","powershell","powershell-script","teams"],"latest_commit_sha":null,"homepage":"https://gal.vin/posts/logon-audit-utility/","language":"PowerShell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Digressive.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-09-28T16:33:36.000Z","updated_at":"2024-05-14T20:47:58.000Z","dependencies_parsed_at":"2024-05-15T13:55:32.960Z","dependency_job_id":"32cdcb6b-4dc4-40ae-95de-46fc06432698","html_url":"https://github.com/Digressive/Logon-Audit","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Digressive%2FLogon-Audit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Digressive%2FLogon-Audit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Digressive%2FLogon-Audit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Digressive%2FLogon-Audit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Digressive","download_url":"https://codeload.github.com/Digressive/Logon-Audit/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225606625,"owners_count":17495551,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["logon-audit","logs","powershell","powershell-script","teams"],"created_at":"2024-11-20T17:57:27.153Z","updated_at":"2025-07-10T00:32:35.466Z","avatar_url":"https://github.com/Digressive.png","language":"PowerShell","funding_links":["https://github.com/sponsors/Digressive","https://www.paypal.me/digressive"],"categories":[],"sub_categories":[],"readme":"# Logon Audit Utility\n\n## Really simple log on/off auditing utility\n\nFor full change log and more information, [visit my site.](https://gal.vin/utils/logon-audit-utility/)\n\nLogon Audit Utility is available from:\n\n* [GitHub](https://github.com/Digressive/Logon-Audit)\n* [The Microsoft PowerShell Gallery](https://www.powershellgallery.com/packages/Logon-Audit)\n\nPlease consider supporting my work:\n\n* Support with [Github Sponsors](https://github.com/sponsors/Digressive).\n* Support with a one-time donation using [PayPal](https://www.paypal.me/digressive).\n\nPlease report any problems via the ‘issues’ tab on GitHub.\n\nThanks\n-Mike\n\n## Features and Requirements\n\n* The utility should be run on a client machine.\n* It is ideally triggered as a logon/logoff script by Group Policy.\n* Any files that the script needs to access should be accessible from a client device.\n* It can be used to log to a file, send to a webhook or both.\n* The utility requires at least PowerShell 5.0.\n* Tested on Windows 11, Windows 10, Windows Server 2022, Windows Server 2019, Windows Server 2016 and Windows Server 2012 R2.\n\n## Configuration\n\nHere’s a list of all the command line switches and example configurations.\n\n| Command Line Switch | Description | Example |\n| ------------------- | ----------- | ------- |\n| -Logon | Use this option to log a log on event. | N/A |\n| -Logoff | Use this option to log a log off event. | N/A |\n| -Webhook | The txt file containing the URI for a webhook to send the log file to. | [path\\]webhook.txt |\n| -L | The path to output the log file to. | [path\\logs] |\n| -Help | Display usage information. No arguments also displays help. | N/A |\n\n## Example\n\n``` txt\n[path\\]Logon-Audit.ps1 -Logon -L [path]\n```\n\nThe above command will record a logon event for the currently logged on user to the log file and also to Teams.\n\n## Change Log\n\n### 2023-04-28: Version 23.04.28\n\n* Changed the -Teams switch to -Webhook to better represent it's function.\n\n### 2022-06-14: Version 22.05.30\n\n* Added checks and balances to help with configuration as I'm very aware that the initial configuration can be troublesome. Running the utility manually is a lot more friendly and step-by-step now.\n* Added -Help to give usage instructions in the terminal. Running the script with no options will also trigger the -help switch.\n* Cleaned user entered paths so that trailing slashes no longer break things or have otherwise unintended results.\n* Added -LogRotate [days] to removed old logs created by the utility.\n* Streamlined config report so non configured options are not shown.\n* Added donation link to the ASCII banner.\n* Cleaned up code, removed unneeded log noise.\n\n### 2021-12-08: Version 21.12.08\n\n* Configured logs path now is created, if it does not exist.\n* Added OS version info.\n* Added Utility version info.\n* Added Hostname info.\n* Changed a variable to prevent conflicts with future PowerShell versions.\n\n### 2020-03-12: Version 20.03.12 'Chick'\n\n* Added option to send an event to Microsoft Teams.\n* Refactored code.\n* Fully backwards compatible.\n\n### 2019-09-28 v1.0\n\n* Initial public release.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdigressive%2Flogon-audit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdigressive%2Flogon-audit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdigressive%2Flogon-audit/lists"}