InfocyteHUNTAPI

1.6.6

scan_schedule.ps1

                                
function Add-ICScanSchedule {

    [cmdletbinding()]

    param(

        [parameter(Mandatory)]

        [ValidateNotNullOrEmpty()]

        [String]$TargetGroupId,

        [parameter(Mandatory)]

        [ValidateNotNullOrEmpty()]

        [String]$CronExpression,

        [PSObject]$ScanOptions

    )

    $TargetGroup = Get-ICTargetGroup -TargetGroupId $TargetGroupId

    if (-NOT $TargetGroup) {

        Throw "No such target group with id $TargetGroupId"

    }

    $Endpoint = "scheduledJobs"

    Write-Verbose "Creating new schedule for TargetGroup: $($TargetGroup.name) with Cron Express: $CronExpression"

    $body = @{

        name = 'scan-scheduled'

        relatedId = $TargetGroupId

        schedule = $CronExpression

        data = @{

            targetId = $TargetGroupId

        }

    }

    if ($ScanOptions) {

        if ($ScanOptions.EnableProcess -eq $True) {

                $body.data['options'] = $ScanOptions

        } else {

            Throw "ScanScheduleOptions format is invalid -- use New-ICScanScheduleOptions to create an options object"

        }

    }

    Invoke-ICAPI -Endpoint $Endpoint -body $body -method POST

}

function Get-ICScanSchedule {

    [cmdletbinding()]

    param(

        [String]$Id,

        [String]$TargetGroupId,

        [HashTable]$where=@{}

    )

    $Endpoint = "ScheduledJobs"

    if ($TargetGroupId) {

        $TargetGroups = Get-ICTargetGroup -TargetGroupId $TargetGroupId

        $ScheduledJobs = Get-ICAPI -Endpoint $Endpoint -where $where -NoLimit:$true | Where-Object { $_.relatedId -eq $TargetGroupId}

    } else {

        $TargetGroups = Get-ICTargetGroup

        $ScheduledJobs = Get-ICAPI -Endpoint $Endpoint -where $where -NoLimit:$true

    }

    $ScheduledJobs | % {

        if ($_.relatedId) {

             $tgid = $_.relatedId

             $tg = $TargetGroups | Where-Object { $_.id -eq $tgid }

             if ($tg) {

                 $_ | Add-Member -MemberType "NoteProperty" -name "targetGroup" -value $tg.name

             } else {

                 $_ | Add-Member -MemberType "NoteProperty" -name "targetGroup" -value $Null

             }

        }

    }

    $ScheduledJobs

}

function Remove-ICScanSchedule {

    [cmdletbinding(SupportsShouldProcess, DefaultParameterSetName = 'scheduleId')]

    param(

        [parameter(

            Mandatory,

            ParameterSetName  = 'scheduleId',

            Position = 0,

            ValueFromPipeline,

            ValueFromPipelineByPropertyName

        )]

        [ValidateScript({ if ($_ -match $GUID_REGEX) { $true } else { throw "Incorrect input: $_.  Should be a guid."} })]

        [alias('scheduleId')]

        [string]$Id,

        [parameter(Mandatory, ParameterSetName  = 'targetGroupId')]

        [ValidateNotNullOrEmpty()]

        [Alias("targetId")]

        $targetGroupId

    )

    PROCESS {

        if (-NOT $Id -AND $_ ) {

            Write-Debug "Taking input from raw pipeline (`$_): $_."

            $Id = $_

        }

        $Schedules = Get-ICScanSchedule

        if ($Id) {

            $schedule = $Schedules | Where-Object { $_.id -eq $Id}

        }

        elseif ($TargetGroupId) {

            $schedule = $Schedules | Where-Object { $_.relatedId -eq $TargetGroupId}

            $ScheduleId    = $schedule.id

        } else {

            throw "Incorrect input!"

        }

        $tgname = $schedule.targetGroup

        if (-NOT $tgname) { throw "TargetGroupId not found!"}

        $Endpoint = "scheduledJobs/$ScheduleId"

        if ($PSCmdlet.ShouldProcess($Id, "Will remove schedule from $tgname")) {

            Write-Warning "Unscheduling collection for Target Group $tgname"

            Invoke-ICAPI -Endpoint $Endpoint -method DELETE

        }

    }

}

# SIG # Begin signature block

# MIINOAYJKoZIhvcNAQcCoIINKTCCDSUCAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB

# gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR

# AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQUxnnuEZT3WsZJdjoTHqo/meDd

# oNKgggp2MIIFHzCCBAegAwIBAgIQA7ShIT20JORyIag/jWOSyzANBgkqhkiG9w0B

# AQsFADB2MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYD

# VQQLExB3d3cuZGlnaWNlcnQuY29tMTUwMwYDVQQDEyxEaWdpQ2VydCBTSEEyIEhp

# Z2ggQXNzdXJhbmNlIENvZGUgU2lnbmluZyBDQTAeFw0xODA5MTIwMDAwMDBaFw0y

# MDExMTgxMjAwMDBaMF4xCzAJBgNVBAYTAlVTMQ4wDAYDVQQIEwVUZXhhczEPMA0G

# A1UEBxMGQXVzdGluMRYwFAYDVQQKEw1JbmZvY3l0ZSwgSW5jMRYwFAYDVQQDEw1J

# bmZvY3l0ZSwgSW5jMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEApzcR

# GuszlupWLdmtti4glKsr6SS2sp370yioc2XyIwPzU/etsBQa41x6VO7HXjtSXSry

# p3SYaoLPQmBiAzKjDP6dzu0l7cQFbwPMky3SGqrC3Wr+Kw/qoMgn3wKBxzPJ53Gj

# s1oxNwyz2N7FwN977vErW9C/FgM/XuE7Zde/HGl3oxTJNtY++BG2Ri3rwi5hNbzV

# 5+avrJFW1DzHVBXYxbrE9vNy4V6s7dlZT2xZoJ3AtHoBCUMgHRKii3wHgFRaxiuz

# 6XzlvHzmnh02KUfoV6cX++bP4bRtsJjmvrfJV+Mhlh/MhUidhhQQx0spLIfxv+vZ

# OACP5jLm0g2fj4G4VQIDAQABo4IBvzCCAbswHwYDVR0jBBgwFoAUZ50PIAkMzIo6

# 5YJGcmL88cyQ5UAwHQYDVR0OBBYEFBqi6MjBKip4kQYxVCjC7yOrUHWFMA4GA1Ud

# DwEB/wQEAwIHgDATBgNVHSUEDDAKBggrBgEFBQcDAzBtBgNVHR8EZjBkMDCgLqAs

# hipodHRwOi8vY3JsMy5kaWdpY2VydC5jb20vc2hhMi1oYS1jcy1nMS5jcmwwMKAu

# oCyGKmh0dHA6Ly9jcmw0LmRpZ2ljZXJ0LmNvbS9zaGEyLWhhLWNzLWcxLmNybDBM

# BgNVHSAERTBDMDcGCWCGSAGG/WwDATAqMCgGCCsGAQUFBwIBFhxodHRwczovL3d3

# dy5kaWdpY2VydC5jb20vQ1BTMAgGBmeBDAEEATCBiAYIKwYBBQUHAQEEfDB6MCQG

# CCsGAQUFBzABhhhodHRwOi8vb2NzcC5kaWdpY2VydC5jb20wUgYIKwYBBQUHMAKG

# Rmh0dHA6Ly9jYWNlcnRzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydFNIQTJIaWdoQXNz

# dXJhbmNlQ29kZVNpZ25pbmdDQS5jcnQwDAYDVR0TAQH/BAIwADANBgkqhkiG9w0B

# AQsFAAOCAQEABnQP0mJYXNzfz4pMCc4FbQ9qe8NjloGuIlUgXaxlFAoMKZWMueXq

# mciPWULaE+Wd5ChTuNsrWKG7bWYYWmmo7C1RWhdZhQT/C+k3lFcsSr6gdXAXiOmv

# 3xv3d3oqfNe19G6jt6akQ6LjEauRw4xKinoK/S61Pw9c1KtEAGT8djgX74h433fy

# FPiQd//ePnihKN+GXRCeLvSaDGuVrhHuI6UUhe3MK2/Nb8MzFddwkOOdpky1HBn4

# 8oFEAOzbrTVTTv4BWLNRvAiY8UO3D2Kt322UuAdXIKNxWB94UaFt2jg2QsRkTHGQ

# MmbQ8OgMIWWNcE9RcVKuobYbzUAGPoMimTCCBU8wggQ3oAMCAQICEAt+EJA8OEkP

# +i9nmoehp7kwDQYJKoZIhvcNAQELBQAwbDELMAkGA1UEBhMCVVMxFTATBgNVBAoT

# DERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3LmRpZ2ljZXJ0LmNvbTErMCkGA1UE

# AxMiRGlnaUNlcnQgSGlnaCBBc3N1cmFuY2UgRVYgUm9vdCBDQTAeFw0xMzEwMjIx

# MjAwMDBaFw0yODEwMjIxMjAwMDBaMHYxCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxE

# aWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xNTAzBgNVBAMT

# LERpZ2lDZXJ0IFNIQTIgSGlnaCBBc3N1cmFuY2UgQ29kZSBTaWduaW5nIENBMIIB

# IjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAtEpefQcPQd7E9XYWNr1x/88/

# T3NLnNEN/krLV1hehRbdAhVUmfCPPC9NAngQaMjYNUs/wfdnzpgcrjO5LR2kClST

# xIWi3zWx9fE8p7M0+11IyUbJYkS8SJnrKElTwz2PwA7eNZjpYlHfPWtAYe4EQdrP

# p1xWltH5TLdEhIeYaeWCuRPmVb/IknCSCjFvf4syq89rWp9ixD7uvu1ZpFN/C/FS

# iIp7Cmcky5DN7NJNNEyw4bWfnMb2byzN5spTdAGfZzXeOEktzu05RIIZeU4asrX7

# u3jwSWanz/pclnWSixpy2f9QklPMPsJDMgkahhNpPPuBMjMyZHVzKCYdCDA7BwID

# AQABo4IB4TCCAd0wEgYDVR0TAQH/BAgwBgEB/wIBADAOBgNVHQ8BAf8EBAMCAYYw

# EwYDVR0lBAwwCgYIKwYBBQUHAwMwfwYIKwYBBQUHAQEEczBxMCQGCCsGAQUFBzAB

# hhhodHRwOi8vb2NzcC5kaWdpY2VydC5jb20wSQYIKwYBBQUHMAKGPWh0dHA6Ly9j

# YWNlcnRzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydEhpZ2hBc3N1cmFuY2VFVlJvb3RD

# QS5jcnQwgY8GA1UdHwSBhzCBhDBAoD6gPIY6aHR0cDovL2NybDQuZGlnaWNlcnQu

# Y29tL0RpZ2lDZXJ0SGlnaEFzc3VyYW5jZUVWUm9vdENBLmNybDBAoD6gPIY6aHR0

# cDovL2NybDMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0SGlnaEFzc3VyYW5jZUVWUm9v

# dENBLmNybDBPBgNVHSAESDBGMDgGCmCGSAGG/WwAAgQwKjAoBggrBgEFBQcCARYc

# aHR0cHM6Ly93d3cuZGlnaWNlcnQuY29tL0NQUzAKBghghkgBhv1sAzAdBgNVHQ4E

# FgQUZ50PIAkMzIo65YJGcmL88cyQ5UAwHwYDVR0jBBgwFoAUsT7DaQP4v0cB1Jgm

# GggC72NkK8MwDQYJKoZIhvcNAQELBQADggEBAGoO/34TfAalS8AujPlTZAniuliR

# MFDszJ/h06gvSEY2GCnQeChfmFZADx66vbE7h1zcW9ggDe0aFk3VESQhS/EnaZAT

# 6xGhAdr9tU55WXW9OCpqw/aOQSuKoovXLFFR2ZygyONOumyoR9JO0WgfjAJXO7Mp

# ao5qICq58gBiZLrI6QD5zKTUupo12K8sZWwWfFgh3kow0PrrJF0GyZ0Wt61KRdMl

# 4gzwQKpcTax+zQaCuXZGaQjYMraC/uOpWDRDG45nZ5c/aDEWNjiVPof3x8OvnXp3

# Gdnek7X9biv8lPk9t0wSNSwwvuiNngVwmkgT9IzW5x6sOOeo860Mt3rsZ+0xggIs

# MIICKAIBATCBijB2MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5j

# MRkwFwYDVQQLExB3d3cuZGlnaWNlcnQuY29tMTUwMwYDVQQDEyxEaWdpQ2VydCBT

# SEEyIEhpZ2ggQXNzdXJhbmNlIENvZGUgU2lnbmluZyBDQQIQA7ShIT20JORyIag/

# jWOSyzAJBgUrDgMCGgUAoHgwGAYKKwYBBAGCNwIBDDEKMAigAoAAoQKAADAZBgkq

# hkiG9w0BCQMxDAYKKwYBBAGCNwIBBDAcBgorBgEEAYI3AgELMQ4wDAYKKwYBBAGC

# NwIBFTAjBgkqhkiG9w0BCQQxFgQUA/AcFwlMuM0BHvnTamQO7e6BdBAwDQYJKoZI

# hvcNAQEBBQAEggEAJKkoL2qzgQ0tIwByAghgt3qTjxoumkvug3lid2k3c9Z2OudU

# WHdXvIrkYgLpSIChmYFCRGNO1VA8OpC7ZO/7RYoRWoMAbjkqhxFD6U8czoOiWRzx

# z5SScxnTYqi5ii0gUzRgwT5CcXKiut1jzJHL81JEvaq+5podr/t759VuSwxIjXF2

# Wqvq6i/J1fA+Ydli1Y8EfvaLI38+17zry9qXcWk20b7rMHoef7A9UGpSWoL6tgIy

# 3W8QqAHuuUXCcL4sV8n3CnCqsvvft98v+ebSZMtwd7nvdGcCUQ9ZoLsU3E8st1s0

# XnaIxopXQIX3WWfP+zpxmWgT5L7e3ShBgGL9Ug==

# SIG # End signature block