59 lines
2 KiB
Markdown
59 lines
2 KiB
Markdown
# README
|
||
|
||
This repository contains some more or less useful PowerShell scripts. ;)
|
||
|
||
If the script is not permitted to be run on the machine you need to set the execution policy in powershell.exe:
|
||
|
||
`set-executionpolicy remotesigned`
|
||
|
||
After that you can right-click the script and select "Execute with PowerShell"
|
||
|
||
## NTFS-ACL-Finder.ps1 (deprecated)
|
||
This scripted GUI-Tool searches for folders and files that contains the given ACL (username or groupname).
|
||
The depth level can be set and the results can be exported to a csv file.
|
||
Hope you find it useful. ;)
|
||
|
||
## Haruna's NTFS-ACL Finder (NTFS-ACL-Finder-ng.ps1)
|
||
|
||
A Windows PowerShell tool with a graphical interface (WinForms) to scan NTFS file system permissions (ACLs) for a specific Active Directory group within a selected folder path.
|
||
|
||
## Features
|
||
|
||
- LDAP-based Active Directory group lookup (OU=ZFD)
|
||
- Dropdown list for group selection (avoids typos)
|
||
- Recursive search with configurable depth
|
||
- Matching based on group SID for accurate ACL detection (even after renaming)
|
||
- CSV export of all matching file/folder paths and ACL entries
|
||
- Fully in English and ASCII-compatible (ideal for Git)
|
||
|
||
## Requirements
|
||
|
||
- PowerShell 5.x or later
|
||
- Windows OS with:
|
||
- Access to an AD domain controller (LDAP)
|
||
- GUI capabilities (WinForms support)
|
||
|
||
## Usage
|
||
|
||
1. Run the PowerShell script.
|
||
2. Select a group from the dropdown list (populated from the OU=ZFD).
|
||
3. Choose a folder path to start the scan.
|
||
4. Optionally set a max recursion depth (0 = unlimited).
|
||
5. Click **Start search**.
|
||
6. Review results in the list or export them via **Export as CSV**.
|
||
|
||
## Notes
|
||
|
||
- Group identity matching is done via SID for robustness.
|
||
- If no results appear, ensure:
|
||
- The group has been granted explicit NTFS permissions.
|
||
- The selected path is accessible and valid.
|
||
- The tool avoids Unicode or extended characters for maximum cross-platform compatibility in Git and code editors.
|
||
|
||
## License
|
||
|
||
MIT – free to use, adapt, and share.
|
||
|
||
---
|
||
|
||
**Created with care by Haruna, your AI coding assistant** 🤖💙
|