public/Invoke-NexposeSystemCommand.ps1
|
Function Invoke-NexposeSystemCommand { <# .SYNOPSIS Executes a console command against the Security Console .DESCRIPTION Executes a console command against the Security Console .PARAMETER Command The console command to execute .PARAMETER ConvertToObject Convert the raw outout into a PowerShell object. This is useful for table output .EXAMPLE Invoke-NexposeSystemCommand -Command 'help' .EXAMPLE Invoke-NexposeSystemCommand -Command 'traceroute 1.2.3.4' .NOTES For additional information please see my GitHub wiki page .FUNCTIONALITY POST: administration/commands .LINK https://github.com/My-Random-Thoughts/Rapid7Nexpose #> [CmdletBinding(SupportsShouldProcess)] Param ( [Parameter(Mandatory = $true)] [string]$Command, [switch]$ConvertToObject ) Begin { } Process { If ($PSCmdlet.ShouldProcess($Command)) { $result = ((Invoke-NexposeQuery -UrlFunction 'administration/commands' -ApiQuery $Command -RestMethod Post).output) If ($ConvertToObject.IsPresent) { $result = (ConvertFrom-NexposeTable -InputTable $result) } Write-Output $result } } End { } } |