jschuller-doc / powershell-scanners

A community repository of PowerShell Scanners for PDQ Inventory.

Table of contents

• Downloading
  • Git
  • ZIP
• Importing
• Contributing

Downloading

Git

The best way to use this repository is with Git. It makes updating very easy and allows you to contribute your own PowerShell scanners or fixes.

Setup

1. Install Git. We have a package for this in PDQ Deploy's Package Library ;)
2. Clone this repository to the root of your C drive. This is necessary because the PowerShell Scanner feature does not currently support variables all will assume C:\PowerShell-Scanners.

git clone https://github.com/pdq/PowerShell-Scanners.git C:\PowerShell-Scanners

Updating

1. Navigate to your clone of this repository.
2. Run git pull.

cd C:\PowerShell-Scanners
git pull

ZIP

An alternative download method if you can't/don't want to install Git.

Setup

1. Click the green "Code" button toward the top-right of this page.
2. Click the "Download ZIP" link.
3. Save the ZIP anywhere you want.
4. Extract the contents of the ZIP to the root of your C drive. This is necessary because the PowerShell Scanner feature does not currently support variables.
5. Rename PowerShell-Scanners-master to PowerShell-Scanners.

Updating

1. Delete C:\PowerShell-Scanners (as long as you haven't edited anything!).
2. Follow the Setup instructions again.

Importing

Now that you have this repository downloaded, it's time to import the PowerShell Scanner profile(s) that you want!

1. Open PDQ Inventory (version 19.0.40.0 or later).
2. Go to File --> Import.
3. Navigate to the folder of the PowerShell Scanner you want, such as C:\PowerShell-Scanners\PowerShell Scanners\Mapped Drives.
4. Click on Scan Profile.xml.
5. Click the Open button.

That's it! To update your imported profile(s), follow the appropriate Updating section above. You shouldn't have to re-import any Scan Profiles unless you see a note telling you to in that profile's README file.

Contributing

If you have created a PowerShell Scanner that you would like to add to this repository, please read the Contributing guide.