CarbonBlackPS

1.0

Public/Get-CbVulnerabilitySummary.ps1

                                <#

    .SYNOPSIS

    Get a Vulnerability Summary at the organization level.

    Official Carbon Black documentation: https://developer.carbonblack.com/reference/carbon-black-cloud/platform/latest/vulnerability-assessment/#get-vulnerability-summary

    .EXAMPLE

    Get-CbVulnerabilitySummary

#>

function Get-CbVulnerabilitySummary {

    param ()

    $queryString = "?status=$Status"

    if ($SortField) {$queryString += "?sort_field=$SortField"}

    if ($SortOrder) {$queryString += "?sort_order=$SortOrder"}

    if ($DeploymentType) {$queryString += "?deployment_type=$DeploymentType"}

    if ($TargetPriority) {$queryString += "?target_priority=$TargetPriority"}

    if ($Search) {$queryString += "?query_string=$Search"}

    if ($PolicyID) {$queryString += "?policy_id=$PolicyID"}

    if ($ADGroupID) {$queryString += "?ad_group_id=$ADGroupID"}

    $Parameters = @{

        UriPreOrgKey  = "/vulnerability/assessment/api/v1/orgs/"

        UriPostOrgKey = "/vulnerabilities/summary"

        Method     = "Get"

    }

    $result = Invoke-CbMethod @Parameters

    $result | Out-File -FilePath $FilePath

}