Public/Get-SSCApplicationVersionArtifacts.ps1
|
function Get-SSCApplicationVersionArtifacts { <# .SYNOPSIS Get SSC Application Version Artifacts. .DESCRIPTION Get information about SSC Application Version Artifacts. .PARAMETER Id The id of the parent application version. .PARAMETER Fields A comma separated list of fields to return. .PARAMETER Query A search-spec of full text search query. .PARAMETER OrderBy A comma separated list of fields to order by. .PARAMETER Start Starting offset for artifacts returned. Default is 0. .PARAMETER Limit Limit the number of artifacts returned to this number. If '-1' or '0' no limit is applied . Default is 200. .PARAMETER Raw If specified, provide raw output and do not parse any responses. .PARAMETER Token SSC token to use. If empty, the value from PS4SSC will be used. .PARAMETER Proxy Proxy server to use. Default value is the value set by Set-SSCConfig .EXAMPLE # Get any artifacts of Application id 100 where their status is "REQUIRE_AUTH" Get-SSCApplicationVersionArtifacts -Query "status:REQUIRE_AUTH" .LINK http://localhost:8080/ssc/html/docs/api-reference/index.jsp#/artifact-of-project-version-controller/listArtifactOfProjectVersion .FUNCTIONALITY Fortify Software Security Center #> [CmdletBinding()] param ( [Parameter(Mandatory=$True, ValueFromPipeline=$True)] [int]$Id, [string]$Fields, [string]$Query, [string]$OrderBy, [switch]$Raw, [int]$Start = 0, [int]$Limit = 200, [Parameter()] [ValidateNotNullOrEmpty()] [string]$Token = $Script:PS4SSC.Token, [Parameter()] [ValidateNotNullOrEmpty()] [string]$SscUri = $Script:PS4SSC.SscUri, [Parameter()] [ValidateNotNullOrEmpty()] [string]$Proxy = $Script:PS4SSC.Proxy, [switch]$ForceVerbose = $Script:PS4SSC.ForceVerbose ) begin { $Params = @{} if ($Proxy) { $Params['Proxy'] = $Proxy } if ($ForceVerbose) { $Params.Add('ForceVerbose', $True) $VerbosePreference = "Continue" } Write-Verbose "Get-SSCScanCentralSASTJobs Bound Parameters: $( $PSBoundParameters | Remove-SensitiveData | Out-String )" $Body = @{ start = $Start limit = $Limit } if ($Fields) { $Body.Add("fields", $Fields) } if ($OrderBy) { $Body.Add("orderby", $OrderBy) } if ($Query) { $Body.Add("q", $Query) } $RawArtifacts = @() $TotalCount = 0 } process { Write-Verbose "Send-SSCApi -Method Get -Operation 'api/v1/projectVersions/$Id/artifacts'" #$Params $Response = Send-SSCApi -Method Get -Operation "/api/v1/projectVersions/$Id/artifacts" -Body $Body @Params $TotalCount = $Response.count $RawArtifacts = $Response.data Write-Verbose "Retrieved $TotalCount artifacts" } end { if ($Raw) { $RawArtifacts } else { Parse-SSCArtifact -InputObject $RawArtifacts } } } |