aboutsummaryrefslogtreecommitdiff
path: root/docs/Recon/Get-HttpStatus.md
blob: 4311983062c7d9d4d182d0eb49590bd15ca43b6f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
# Get-HttpStatus

## SYNOPSIS
Returns the HTTP Status Codes and full URL for specified paths.

PowerSploit Function: Get-HttpStatus  
Author: Chris Campbell (@obscuresec)  
License: BSD 3-Clause  
Required Dependencies: None  
Optional Dependencies: None

## SYNTAX

```
Get-HttpStatus [-Target] <String> [[-Path] <String>] [[-Port] <Int32>] [-UseSSL]
```

## DESCRIPTION
A script to check for the existence of a path or file on a webserver.

## EXAMPLES

### -------------------------- EXAMPLE 1 --------------------------
```
Get-HttpStatus -Target www.example.com -Path c:\dictionary.txt | Select-Object {where StatusCode -eq 20*}
```

### -------------------------- EXAMPLE 2 --------------------------
```
Get-HttpStatus -Target www.example.com -Path c:\dictionary.txt -UseSSL
```

## PARAMETERS

### -Target
Specifies the remote web host either by IP or hostname.

```yaml
Type: String
Parameter Sets: (All)
Aliases: 

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Path
Specifies the remost host.

```yaml
Type: String
Parameter Sets: (All)
Aliases: 

Required: False
Position: 2
Default value: .\Dictionaries\admin.txt
Accept pipeline input: False
Accept wildcard characters: False
```

### -Port
Specifies the port to connect to.

```yaml
Type: Int32
Parameter Sets: (All)
Aliases: 

Required: False
Position: 3
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
```

### -UseSSL
Use an SSL connection.

```yaml
Type: SwitchParameter
Parameter Sets: (All)
Aliases: 

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
```

## INPUTS

## OUTPUTS

## NOTES
HTTP Status Codes: 100 - Informational * 200 - Success * 300 - Redirection * 400 - Client Error * 500 - Server Error

## RELATED LINKS

[http://obscuresecurity.blogspot.com
http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html]()