New-URLScan¶
SYNOPSIS¶
This function enables you to submit a new scan to URLScan.io
SYNTAX¶
New-URLScan [-URL] <String> [[-Visibility] <String>] [[-SourceCountry] <String>] [[-Referer] <String>]
[[-CustomAgent] <String>] [[-Tags] <Object[]>] [-OverrideSafety] [-WaitForScan] [[-APIKey] <String>]
[<CommonParameters>]
DESCRIPTION¶
This function enables you to submit a new scan to URLScan.io
EXAMPLES¶
EXAMPLE 1¶
New-URLScan -URL 'https://google.com/test' `
-Visibility public `
-SourceCountry gb `
-Referer 'https://google.com/test2' `
-CustomAgent 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.61 Safari/537.36' `
-Tags @('test','test2')
message : Submission successful
uuid : 4f916fa4-10d9-495c-851d-c8496c7ef534
result : https://urlscan.io/result/4f916fa4-10d9-495c-851d-c8496c7ef534/
api : https://urlscan.io/api/v1/result/4f916fa4-10d9-495c-851d-c8496c7ef534/
visibility : public
options : @{useragent=Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_5) AppleWebKit/537.36 (KHTML, like Gecko)
Chrome/83.0.4103.61 Safari/537.36; headers=}
url : https://google.com/test
country : gb
EXAMPLE 2¶
New-URLScan -URL 'https://infoblox.com/threat-intel' -Visibility private -WaitForScan
Waiting for scan results..
Waiting for scan results..
Waiting for scan results..
data : @{requests=System.Object[]; cookies=System.Object[]; console=System.Object[]; links=System.Object[]; timing=; globals=System.Object[]}
lists : @{ips=System.Object[]; countries=System.Object[]; asns=System.Object[]; domains=System.Object[]; servers=System.Object[]; urls=System.Object[]; linkDomains=System.Object[]; certificates=System.Object[]; hashes=System.Object[]}
meta : @{processors=}
page : @{asn=AS54113; asnname=FASTLY, US; city=Frankfurt am Main; country=DE; domain=www.infoblox.com; ip=146.75.122.253; server=nginx; url=https://www.infoblox.com/threat-intel/; apexDomain=infoblox.com; umbrellaRank=897192; tlsIssuer=R3; tlsValidFrom=5/9/2024 3:27:21 AM; tlsValidDays=89;
tlsAgeDays=36; redirected=sub-domain; status=200; mimeType=text/html; title=Infoblox Threat Intel - Threat Intelligence for DNS}
scanner : @{country=gb}
stats : @{IPv6Percentage=0; adBlocked=0; domainStats=System.Object[]; ipStats=System.Object[]; malicious=0; protocolStats=System.Object[]; regDomainStats=System.Object[]; resourceStats=System.Object[]; securePercentage=97; secureRequests=142; serverStats=System.Object[]; tlsStats=System.Object[];
totalLinks=32; uniqCountries=5}
submitter : @{country=GB}
task : @{apexDomain=infoblox.com; domain=infoblox.com; method=api; source=4e882e8b; tags=System.Object[]; time=6/14/2024 2:28:58 PM; url=https://infoblox.com/threat-intel; uuid=16e64fe3-684e-4a35-8d3b-dc2880b6e04b; visibility=private;
reportURL=https://urlscan.io/result/16e64fe3-684e-4a35-8d3b-dc2880b6e04b/; screenshotURL=https://urlscan.io/screenshots/16e64fe3-684e-4a35-8d3b-dc2880b6e04b.png; domURL=https://urlscan.io/dom/16e64fe3-684e-4a35-8d3b-dc2880b6e04b/}
verdicts : @{overall=; urlscan=; engines=; community=}
PARAMETERS¶
-URL¶
The URL to submit to URLScan.io for scanning
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Visibility¶
The visibility to use when submitting a new scan request (public/unlisted/private). Default is 'public'.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 2
Default value: Public
Accept pipeline input: False
Accept wildcard characters: False
-SourceCountry¶
The source country to use when submitting a new scan request.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 3
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Referer¶
The HTTP Referer to use when submitting a new scan request.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 4
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CustomAgent¶
The HTTP User-Agent to use when submitting a new scan request.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 5
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Tags¶
A list of tags to use when submitting a new scan request.
Type: Object[]
Parameter Sets: (All)
Aliases:
Required: False
Position: 6
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-OverrideSafety¶
If the -OverrideSafety parameter is used, this will disable reclassification of URLs with potential PII in them. Use with care!
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-WaitForScan¶
The -WaitForScan parameter will wait for the scan to complete, then return the results.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-APIKey¶
The -APIKey parameter enables you to specify an API Key if you have an account with URLScan.io. This will enable higher query limits and larger page sizes. This is only necessary if your API Key has not been saved using Set-URLScanConfiguration
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 7
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters¶
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.