InfocyteHUNTAPI

2.0.7

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

# MIINFwYJKoZIhvcNAQcCoIINCDCCDQQCAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB

# gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR

# AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQUxnnuEZT3WsZJdjoTHqo/meDd

# oNKgggpZMIIFITCCBAmgAwIBAgIQD1SHruUyzkN01AFx5d7oATANBgkqhkiG9w0B

# AQsFADByMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYD

# VQQLExB3d3cuZGlnaWNlcnQuY29tMTEwLwYDVQQDEyhEaWdpQ2VydCBTSEEyIEFz

# c3VyZWQgSUQgQ29kZSBTaWduaW5nIENBMB4XDTIwMTExNzAwMDAwMFoXDTIyMTEy

# OTIzNTk1OVowXjELMAkGA1UEBhMCVVMxDjAMBgNVBAgTBVRleGFzMQ8wDQYDVQQH

# EwZBdXN0aW4xFjAUBgNVBAoTDUluZm9jeXRlLCBJbmMxFjAUBgNVBAMTDUluZm9j

# eXRlLCBJbmMwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDNUhaEiZbu

# H7Q6oqA0uq0klkstXkdJU3eJukMrrLpxKdtFqtJwFXcSYp5G/WFlwDRJ8v8fisfp

# SiPS1WajFUHe3EWLh2oXjf44eQYVWQ8SqAn2J8dDLNJ5bWY0w7MD2GrSiTwN0Vi9

# X9pJKJDdm7mJo7bSlZ9p7XvNoraSAx/hkODalPSMvCIVAEOZutlzeWyJ4p0DbTDA

# kjQPF4EZ7JqxYXFeItoi0uYZQNEHbBxr+5SG45ziC8vuwyljIbo+mKD/PwT48OQl

# 9cdnI651Hz+r5kL3t48WvxYrAUJ7g8EJyw2uYnVnSroIC3TmUQHeXS6FuqeObuX7

# MqapBKRcTHvxAgMBAAGjggHFMIIBwTAfBgNVHSMEGDAWgBRaxLl7KgqjpepxA8Bg

# +S32ZXUOWDAdBgNVHQ4EFgQUxKDwshqav/aGaGVOFv67CuwSjcYwDgYDVR0PAQH/

# BAQDAgeAMBMGA1UdJQQMMAoGCCsGAQUFBwMDMHcGA1UdHwRwMG4wNaAzoDGGL2h0

# dHA6Ly9jcmwzLmRpZ2ljZXJ0LmNvbS9zaGEyLWFzc3VyZWQtY3MtZzEuY3JsMDWg

# M6Axhi9odHRwOi8vY3JsNC5kaWdpY2VydC5jb20vc2hhMi1hc3N1cmVkLWNzLWcx

# LmNybDBMBgNVHSAERTBDMDcGCWCGSAGG/WwDATAqMCgGCCsGAQUFBwIBFhxodHRw

# czovL3d3dy5kaWdpY2VydC5jb20vQ1BTMAgGBmeBDAEEATCBhAYIKwYBBQUHAQEE

# eDB2MCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC5kaWdpY2VydC5jb20wTgYIKwYB

# BQUHMAKGQmh0dHA6Ly9jYWNlcnRzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydFNIQTJB

# c3N1cmVkSURDb2RlU2lnbmluZ0NBLmNydDAMBgNVHRMBAf8EAjAAMA0GCSqGSIb3

# DQEBCwUAA4IBAQByJW5tIcmouIY7tdngPLdEOM4FYqLGf9IjKPMS0s+NeTaP/0hp

# dmNeGFEvMozfgDA/gPFCUaRVJwy4rKsGnCznCE1YDA6UFDGZq3VLUbzC6GDP4aY8

# EbfDMbF54TVuOKRue9a6KnVE67gOj+g862qAR6fm/GdeO/KrdvCT1A7xbyg02cCq

# +QgdkYoxI3bsiUwgZ33I2rn2T2zSp8C+RX2bZ8rgtXHxgYLCJdayqMptRsPbxOlQ

# Z7dRhkQXg5D/PyUnpWASF+sLQQ0IMvx8ZKy/P01IhKU0pTJ8OFSYKwPLQnYm1Zp0

# JT/IXZ/tzmtY/StdhaCs3LlOkuHxl2iERxdtMIIFMDCCBBigAwIBAgIQBAkYG1/V

# u2Z1U0O1b5VQCDANBgkqhkiG9w0BAQsFADBlMQswCQYDVQQGEwJVUzEVMBMGA1UE

# ChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNlcnQuY29tMSQwIgYD

# VQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3QgQ0EwHhcNMTMxMDIyMTIwMDAw

# WhcNMjgxMDIyMTIwMDAwWjByMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNl

# cnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNlcnQuY29tMTEwLwYDVQQDEyhEaWdp

# Q2VydCBTSEEyIEFzc3VyZWQgSUQgQ29kZSBTaWduaW5nIENBMIIBIjANBgkqhkiG

# 9w0BAQEFAAOCAQ8AMIIBCgKCAQEA+NOzHH8OEa9ndwfTCzFJGc/Q+0WZsTrbRPV/

# 5aid2zLXcep2nQUut4/6kkPApfmJ1DcZ17aq8JyGpdglrA55KDp+6dFn08b7KSfH

# 03sjlOSRI5aQd4L5oYQjZhJUM1B0sSgmuyRpwsJS8hRniolF1C2ho+mILCCVrhxK

# hwjfDPXiTWAYvqrEsq5wMWYzcT6scKKrzn/pfMuSoeU7MRzP6vIK5Fe7SrXpdOYr

# /mzLfnQ5Ng2Q7+S1TqSp6moKq4TzrGdOtcT3jNEgJSPrCGQ+UpbB8g8S9MWOD8Gi

# 6CxR93O8vYWxYoNzQYIH5DiLanMg0A9kczyen6Yzqf0Z3yWT0QIDAQABo4IBzTCC

# AckwEgYDVR0TAQH/BAgwBgEB/wIBADAOBgNVHQ8BAf8EBAMCAYYwEwYDVR0lBAww

# CgYIKwYBBQUHAwMweQYIKwYBBQUHAQEEbTBrMCQGCCsGAQUFBzABhhhodHRwOi8v

# b2NzcC5kaWdpY2VydC5jb20wQwYIKwYBBQUHMAKGN2h0dHA6Ly9jYWNlcnRzLmRp

# Z2ljZXJ0LmNvbS9EaWdpQ2VydEFzc3VyZWRJRFJvb3RDQS5jcnQwgYEGA1UdHwR6

# MHgwOqA4oDaGNGh0dHA6Ly9jcmw0LmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydEFzc3Vy

# ZWRJRFJvb3RDQS5jcmwwOqA4oDaGNGh0dHA6Ly9jcmwzLmRpZ2ljZXJ0LmNvbS9E

# aWdpQ2VydEFzc3VyZWRJRFJvb3RDQS5jcmwwTwYDVR0gBEgwRjA4BgpghkgBhv1s

# AAIEMCowKAYIKwYBBQUHAgEWHGh0dHBzOi8vd3d3LmRpZ2ljZXJ0LmNvbS9DUFMw

# CgYIYIZIAYb9bAMwHQYDVR0OBBYEFFrEuXsqCqOl6nEDwGD5LfZldQ5YMB8GA1Ud

# IwQYMBaAFEXroq/0ksuCMS1Ri6enIZ3zbcgPMA0GCSqGSIb3DQEBCwUAA4IBAQA+

# 7A1aJLPzItEVyCx8JSl2qB1dHC06GsTvMGHXfgtg/cM9D8Svi/3vKt8gVTew4fbR

# knUPUbRupY5a4l4kgU4QpO4/cY5jDhNLrddfRHnzNhQGivecRk5c/5CxGwcOkRX7

# uq+1UcKNJK4kxscnKqEpKBo6cSgCPC6Ro8AlEeKcFEehemhor5unXCBc2XGxDI+7

# qPjFEmifz0DLQESlE/DmZAwlCEIysjaKJAL+L3J+HNdJRZboWR3p+nRka7LrZkPa

# s7CM1ekN3fYBIM6ZMWM9CBoYs4GbT8aTEAb8B4H6i9r5gkn3Ym6hU/oSlBiFLpKR

# 6mhsRDKyZqHnGKSaZFHvMYICKDCCAiQCAQEwgYYwcjELMAkGA1UEBhMCVVMxFTAT

# BgNVBAoTDERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3LmRpZ2ljZXJ0LmNvbTEx

# MC8GA1UEAxMoRGlnaUNlcnQgU0hBMiBBc3N1cmVkIElEIENvZGUgU2lnbmluZyBD

# QQIQD1SHruUyzkN01AFx5d7oATAJBgUrDgMCGgUAoHgwGAYKKwYBBAGCNwIBDDEK

# MAigAoAAoQKAADAZBgkqhkiG9w0BCQMxDAYKKwYBBAGCNwIBBDAcBgorBgEEAYI3

# AgELMQ4wDAYKKwYBBAGCNwIBFTAjBgkqhkiG9w0BCQQxFgQUA/AcFwlMuM0BHvnT

# amQO7e6BdBAwDQYJKoZIhvcNAQEBBQAEggEApl3O/syFusFBz13TOArnScLgKjTs

# 0bmu5I2jYk2Jc0Vv4+bx8rbNJqWIX1MfWejgT13LaWU2itb31D5GvgWfcw8bULOl

# LbpyXHdh2CkNU3nWTl3UZh+QcvBPJr0h+nQC401o23FXXg5edyg6QM5RvV8UEdnM

# spo6BeXoqMeYXeqjW+rc8M+hbOecNlGIlZLEhamowhvJpRzTQOirUazocrUp0ppL

# P5mRJrU3XPIVsAuBDJmXqshcbQHqDfOuQoD/gMk8GBnsgos6+ftUalwJXqtKVtnV

# v9xqETSAqavh7yeEevn3jtCuD9+ZJ5dpJ4GHLFfo7QG+/2ySjvQ6qRRWPQ==

# SIG # End signature block