{"id":20156188,"url":"https://github.com/dsccommunity/auditpolicydsc","last_synced_at":"2026-03-08T21:02:03.840Z","repository":{"id":57664544,"uuid":"50459130","full_name":"dsccommunity/AuditPolicyDsc","owner":"dsccommunity","description":null,"archived":false,"fork":false,"pushed_at":"2019-02-13T19:25:01.000Z","size":398,"stargazers_count":25,"open_issues_count":6,"forks_count":13,"subscribers_count":8,"default_branch":"dev","last_synced_at":"2025-03-24T00:14:26.013Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/dsccommunity.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":"AuditPolicyDsc.psd1","citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-01-26T21:04:57.000Z","updated_at":"2024-09-01T23:10:08.000Z","dependencies_parsed_at":"2022-09-10T14:52:23.735Z","dependency_job_id":null,"html_url":"https://github.com/dsccommunity/AuditPolicyDsc","commit_stats":null,"previous_names":["powershell/auditpolicydsc"],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dsccommunity%2FAuditPolicyDsc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dsccommunity%2FAuditPolicyDsc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dsccommunity%2FAuditPolicyDsc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dsccommunity%2FAuditPolicyDsc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dsccommunity","download_url":"https://codeload.github.com/dsccommunity/AuditPolicyDsc/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248120109,"owners_count":21050894,"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":[],"created_at":"2024-11-13T23:37:55.598Z","updated_at":"2025-12-11T21:45:26.252Z","avatar_url":"https://github.com/dsccommunity.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AuditPolicyDsc\n\nThe **AuditPolicyDsc** module allows you to configure and manage the advanced audit policy on all\ncurrently supported versions of Windows.\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](\n  https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](\n  https://opensource.microsoft.com/codeofconduct/faq/)\nor contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions\nor comments.\n\n## Branches\n\n### master\n\n[![Build status](https://ci.appveyor.com/api/projects/status/9nsi30ladk1jaax5/branch/master?svg=true)](https://ci.appveyor.com/project/PowerShell/AuditPolicyDsc/branch/master)\n[![codecov](https://codecov.io/gh/PowerShell/AuditPolicyDsc/branch/master/graph/badge.svg)](https://codecov.io/gh/PowerShell/AuditPolicyDsc/branch/master)\n\nThis is the branch containing the latest release -\nno contributions should be made directly to this branch.\n\n### dev\n\n[![Build status](https://ci.appveyor.com/api/projects/status/9nsi30ladk1jaax5/branch/master?svg=true)](https://ci.appveyor.com/project/PowerShell/AuditPolicyDsc/branch/dev)\n[![codecov](https://codecov.io/gh/PowerShell/AuditPolicyDsc/branch/dev/graph/badge.svg)](https://codecov.io/gh/PowerShell/AuditPolicyDsc/branch/dev)\n\nThis is the development branch\nto which contributions should be proposed by contributors as pull requests.\nThis development branch will periodically be merged to the master branch,\nand be released to [PowerShell Gallery](https://www.powershellgallery.com/).\n\n## Contributing\n\nPlease check out common DSC Resources [contributing guidelines](\n  https://github.com/PowerShell/DscResources/blob/master/CONTRIBUTING.md).\n\n## Resources\n\n* [AuditPolicySubcategory](#AuditPolicySubcategory): Provides a mechanism to manage advanced auditpolicy subcategory audit flags.\n\n* [AuditPolicyOption](#AuditPolicyOption): Provides a mechanism to manage audit policy options.\n\n* [AuditPolicyCsv](#AuditPolicyCsv): Provides a mechanism to restore an audit policy backup from a CSV file.\n\n* [AuditPolicyGUID](#AuditPolicyGuid): Provides a version of AuditPolicySubcategory that works around localization issues with auditpol.\n\n### AuditPolicySubcategory\n\nProvides a mechanism to manage advanced audit policy subcategory audit flags.\nThis resource works on Nano Server.\n\n#### Requirements\n\nNone\n\n#### Parameters\n\n* **[String] Name _(Key)_**: The name of the subcategory in the advanced audit policy to manage.\n\n* **[String] AuditFlag _(Key)_**: The name of the audit flag to apply to the subcategory. { Success | Failure }.\n\n* **[String] Ensure _(Write)_**: Indicates whether the service is present or absent. Defaults to Present. { *Present* | Absent }.\n\n#### Read-Only Properties from Get-TargetResource\n\nNone\n\n#### Examples\n\n* [Set Audit Policy Subcategory Audit Flags](\n  https://github.com/PowerShell/AuditPolicyDsc/blob/master/Examples/Sample_AuditPolicySubcategory.ps1)\n\n### AuditPolicyOption\n\nProvides a mechanism to manage audit policy options.\nThis resource works on Nano Server.\n\n#### Requirements\n\nNone\n\n#### Parameters\n\n* **[String] Name _(Key)_**: The name of the option to configure.\n\n* **[String] Value _(Key)_**: The value to apply to the option. { Enabled | Disabled }.\n\n#### Read-Only Properties from Get-TargetResource\n\nNone\n\n#### Examples\n\n* [Set Audit Policy Option](\n  https://github.com/PowerShell/AuditPolicyDsc/blob/master/Examples/Sample_AuditPolicyOption.ps1)\n\n### AuditPolicyCsv\n\nProvides a mechanism to restore an audit policy backup.\nThis resource works on Nano Server.\n\n#### Requirements\n\nNone\n\n#### Parameters\n\n* **[String] CsvPath _(Required)_**: The path to the CSV file to apply to the node.\n\n* **[String] IsSingleInstance _(Key)_**: Specifies if the resource is a single instance, the value must be 'Yes'.\n\n#### Read-Only Properties from Get-TargetResource\n\nNone\n\n#### Examples\n\n* [Apply audit policy backup from a CSV file](\n  https://github.com/PowerShell/AuditPolicyDsc/blob/master/Examples/Sample_AuditPolicyCsv.ps1)\n\n### AuditPolicyGuid\n\nProvides a version of AuditPolicySubcategory that works around localization issues with auditpol.\n\n#### Requirements\n\nNone\n\n#### Parameters\n\n* **[String] Name _(Key)_**: The name of the subcategory in the advanced audit policy to manage.\n\n* **[String] AuditFlag _(Key)_**: The name of the audit flag to apply to the subcategory. { Success | Failure }.\n\n* **[String] Ensure _(Write)_**: Indicates whether the service is present or absent. Defaults to Present. { *Present* | Absent }.\n\n#### Read-Only Properties from Get-TargetResource\n\nNone\n\n#### Examples\n\n* [Set Audit Policy Subcategory Audit Flags](\n  https://github.com/PowerShell/AuditPolicyDsc/blob/master/Examples/Sample_AuditPolicyGuid.ps1)\n\n## Versions\n\n### Unreleased\n\n### 1.4.0.0\n\n* Explicitly removed extra hidden files from release package\n\n### 1.3.0.0\n\n* Update LICENSE file to match the Microsoft Open Source Team standard.\n* Added the AuditPolicyGuid resource.\n\n### 1.2.0.0\n\n*  Moved auditpol call in the helper module to an external process to better control output\n* auditpol output is now converted to CSV to remove the need to parse the text output\n* All resources have been updated to use the new helper module functionality\n* Added the Ensure parameter default value of Present to the AuditPolicySubcategory resource Test-TargetResource function\n\n### 1.1.0.0\n\n* Added the AuditPolicyCsv resource.\n\n### 1.0.0.0\n\n* Initial release with the following resources:\n\n  * AuditPolicySubcategory\n  * AuditPolicyOption\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdsccommunity%2Fauditpolicydsc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdsccommunity%2Fauditpolicydsc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdsccommunity%2Fauditpolicydsc/lists"}