Public/Get-UrlScanioScan.ps1
|
function Get-UrlScanioScan { <# .SYNOPSIS Get urlscan.io scan results. .DESCRIPTION Get urlscan.io scan results for the provided uuid. Returns results as an object by default. .PARAMETER uuid UUID of scan to get details on. .PARAMETER Raw Returns data as raw json. .EXAMPLE Get-UrlScanioScan -uuid b14db0aa-013c-4aa9-ad5a-ec947a2278c7 Get urlscan.io report for the scan with uuid b14db0aa-013c-4aa9-ad5a-ec947a2278c7 .INPUTS System.String. UUID's of scans can be piped to Get-UrlScanioScan. System.Object. Objects containing a property of a scans UUID can be piped to Get-UrlScanioScan. .OUTPUTS System.String. Data can be returned as a json string. System.Object. Data can be returned as an Object. .NOTES .LINK #> [CmdletBinding()] param ( [Parameter(Mandatory = $true, Position = 0, ValueFromPipelineByPropertyName)] [ValidatePattern('[\d\w]{8}-[\d\w]{4}-[\d\w]{4}-[\d\w]{4}-[\d\w]{12}')] [string]$uuid, [Parameter(Mandatory = $false)] [switch]$Raw ) process { $request = Invoke-RestMethod -Uri "https://urlscan.io/api/v1/result/$uuid" -Headers $headers -ErrorAction:SilentlyContinue if ($PSBoundParameters.Raw) { $request = $request | ConvertTo-Json } } end { return $request } } |