nickhakkz / PoshNmap

A Powershell Wrapper for the Nmap Network Discovery Tool

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

PoshNmap

PSGallery PSGalleryDL

ADO GHRelease

ADOvNext GHPreRelease


This project's goal is to deliver an effective wrapper around the Nmap Network Discovery tool, providing Powershell-y behavior and sensible autocomplete as well as formatting output into usable, parseable Powershell objects for better filtering and analysis than trying to use the nmap raw text or XML output formats.

Why

People are constantly trying to reinvent the wheel on network discovery in Powershell, via Test-Netconnection, Test-Connection, ping sweep scripts. Immediately they realize the timeout issues with these options make them slow, slow, slow. Nmap is an extremely well optimized and mature tool for this purpose, and available everywhere Powershell Core is. However, its syntax is obtuse, and its default output does not lend itself well to parsing and analytics by other tools. PoshNmap aims to solve those problems by providing a friendly Powershell interface to the tool.

Features

  • PS 5.1 and Core Compatible
  • Powershell Cmdlet to interact with Nmap in a friendly way.
  • Intellisense and Tab Autocomplete for relevant parameters (-Preset, -OutFormat, etc.)
  • Power users can do advanced scans with -ArgumentList parameter
  • Real time status updates via Write-Progress including percent complete and ETA
  • Default output is a friendly list of Powershell objects representing scanned hosts
  • Multiple output format options: Raw Nmap, XML, JSON, PSObject, Hashtable
  • Detailed Verbose output including the underlying nmap command line that was run

Demo

Simple Scan

Simple Scan with Custom Arguments (nmap-style)

Scan of Home Router using QuickPlus Preset (Includes OS/Service Fingerprinting)

Scan using various output formats

Installation

Visit the Powershell Gallery for installation options.

You must also have Nmap already installed and in your path. Visit nmap.org for various install options. It is usually available in Various package managers, and is available in Chocolatey for windows with choco install nmap

About

A Powershell Wrapper for the Nmap Network Discovery Tool

License:MIT License


Languages

Language:PowerShell 100.0%