Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sc4rfurry/pwskul
This script takes a CIDR notation as input and checks if hosts within that range are alive. It supports multiple CIDR inputs, custom ping count, timeout, and output options. Additionally, it can perform port scanning on alive hosts and resolve DNS names.
https://github.com/sc4rfurry/pwskul
network-scanner powershell scanner
Last synced: 26 days ago
JSON representation
This script takes a CIDR notation as input and checks if hosts within that range are alive. It supports multiple CIDR inputs, custom ping count, timeout, and output options. Additionally, it can perform port scanning on alive hosts and resolve DNS names.
- Host: GitHub
- URL: https://github.com/sc4rfurry/pwskul
- Owner: sc4rfurry
- License: mit
- Created: 2024-09-16T20:15:29.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2024-09-18T18:47:27.000Z (about 2 months ago)
- Last Synced: 2024-10-13T00:01:37.960Z (26 days ago)
- Topics: network-scanner, powershell, scanner
- Language: HTML
- Homepage: https://sc4rfurry.github.io/PWSkuL-Docs/
- Size: 15.6 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
```
.---.
_________ _...._ . | |
\ |.' '-. _ _ .'| | |
\ .'```'. '. /\ \\ // .' | | |
\ | \ \`\\ //\\ // < | | |
| | | | \`// \'/ _ | | ____ _ _ | |
| \ / . \| |/.' | | | \ .' | ' / || |
| |\`'-.-' .' ' . | /| |/ . .' | .' || |
| | '-....-'` .'.'| |//| /\ \ / | / || |
.' '. .'.'.-' / | | \ \ | `'. |'---'
'-----------' .' \_.' ' \ \ \ ' .'| '/
'------' '---'`-' `--'
```
# PWSkul // NetRecon Toolkit
[](LICENSE)
[](https://docs.microsoft.com/en-us/powershell/scripting/overview?view=powershell-7.1)
[](CONTRIBUTING.md)
## // Table_of_Contents
- [Overview](#overview)
- [Key_Features](#key_features)
- [Getting_Started](#getting_started)
- [Prerequisites](#prerequisites)
- [Basic_Usage](#basic_usage)
- [Parameters](#parameters)
- [Advanced_Usage](#advanced_usage)
- [Output_Formats](#output_formats)
- [Contributing](#contributing)
- [License](#license)
- [Contact](#contact)
## // Overview
**PWSkul** is a sophisticated PowerShell script engineered for comprehensive network reconnaissance. It empowers users to efficiently scan hosts within specified CIDR ranges, offering a versatile toolkit for network administrators and security professionals.
## // Key_Features
- **Multi-CIDR Scanning**: Analyze multiple network ranges simultaneously
- **Customizable Host Discovery**: Fine-tune ping attempts and timeout settings
- **Port Scanning**: Identify open ports on live hosts
- **DNS Resolution**: Retrieve DNS information for discovered hosts
- **Flexible Export Options**: Generate reports in CSV, JSON, or XML formats
- **Exclusion Capabilities**: Omit specific IP addresses or subnets from scans
- **TCP SYN Scanning**: Utilize stealthy SYN packets for host discovery
- **Network Interface Selection**: Choose specific interfaces for targeted scanning
- **Comprehensive Logging**: Maintain detailed records of scan activities
## // Getting_Started
### > Prerequisites
- PowerShell 5.1 or later
### > Basic_Usage
> **Note:** For more details and Docs, refer to the [Docs.html](Docs.html) file.
#
```powershell
.\scanner.ps1 -CIDR "192.168.1.0/24" -PingCount 2 -Timeout 500 -ShowAll
```
### > Parameters
| Param | Function | Default |
|---------------------|----------------------------------------------------------|------------|
| `-CIDR` | Target CIDR notation(s) (single or array) | |
| `-PingCount` | Number of ping attempts per host | 1 |
| `-Timeout` | Ping timeout in milliseconds | 1000 |
| `-ShowAll` | Display results for all hosts | False |
| `-ExportCSV` | Path for CSV export | |
| `-HostThrottleLimit`| Max concurrent host scans | 100 |
| `-PortThrottleLimit`| Max concurrent port scans | 50 |
| `-ResolveDNS` | Enable DNS resolution | False |
| `-Ports` | List of ports to scan | |
| `-TopPorts` | Number of top ports to scan (10, 20, 30, 40, 50) | |
| `-LogFile` | Path to log file | .\scan_log.txt |
| `-OutputFormat` | Result format (CSV, JSON, XML) | CSV |
| `-Exclude` | IP addresses or subnets to exclude | |
| `-UseTcpSyn` | Use TCP SYN for host discovery | False |
| `-NetworkInterface` | Specify network interface for scanning | |
| `-Help` | Display help information | |
| `-Detailed` | Show detailed help | |
## // Advanced_Usage
### > Port_Scanning
```powershell
.\scanner.ps1 -CIDR "192.168.1.0/24" -PingCount 2 -Timeout 500 -ShowAll -Ports "80,443,3306"
```
### > Top_Ports_Scan
```powershell
.\scanner.ps1 -CIDR "192.168.1.0/24" -PingCount 2 -Timeout 500 -ShowAll -TopPorts 20
```
### > CSV_Export
```powershell
.\scanner.ps1 -CIDR "192.168.1.0/24" -PingCount 2 -Timeout 500 -ShowAll -ExportCSV "C:\loot\netmap.csv"
```
### > Subnet_Exclusion
```powershell
.\scanner.ps1 -CIDR "192.168.1.0/24" -PingCount 2 -Timeout 500 -ShowAll -Exclude "192.168.1.0/25"
```
### > TCP_SYN_Discovery
```powershell
.\scanner.ps1 -CIDR "192.168.1.0/24" -PingCount 2 -Timeout 500 -ShowAll -UseTcpSyn
```
### > Detailed_Help
```powershell
.\scanner.ps1 -Detailed
```
## // Output_Formats
PWSkul supports multiple output formats to suit various reporting needs:
- **CSV**: Comma-separated values for easy spreadsheet integration
- **JSON**: Structured data ideal for programmatic analysis
- **XML**: Extensible format for complex data representation
## // Contributing
We welcome contributions from the community! .
## // License
PWSkul is released under the MIT License. See the [LICENSE](LICENSE.md) file for full details.
## // Contact
For inquiries, support, or to report issues, please contact me at [[email protected]](mailto:[email protected]).
---
`PWSkul: Infiltrate. Analyze. Dominate.`