functions/public/Set-QualysScanSchedule.ps1

<#
.Synopsis
    Edit a VM scan schedule
.DESCRIPTION
    Edit a VM scan schedule
.PARAMETER Identity
    The ID of the scan schedule to edit
.PARAMETER Title
    The title of the scan schedule
.PARAMETER Status
    Specify 0 to deactivate the scan schedule, 1 to activate the scan schedule
.PARAMETER OptionProfile
    The id or title of the option profile to use
.PARAMETER AssetGroups
    The titles or ids of asset groups containing the hosts to be scanned. Multiple titles are comma separated
    Use only IDs or titles, do not mix and match.
.PARAMETER Scanners
    The IDs or friendly names of the scanner appliances to be used or “External” for external scanners. Multiple entries are comma separated.
    Use only IDs or friendly names, do not mix and match
.PARAMETER Priority
    Specify a value of 0 - 9 to set a processing priority level for the scan
.PARAMETER Daily
    Have the scan run every specified number of days. Value is an integer from 1 - 365
.PARAMETER Weekly
    Have the scan run every specified number of weeks. Value is an integer from 1 - 52
.PARAMETER Weekdays
    The scan will run only on specified weekdays. Value is one or more days: sunday, monday, tuesday, wednesday, thursday, friday, saturday.
    Multiple days are comma separated. By default all weekdays are selected
.PARAMETER StartDate
    The start date in mm/dd/yyyy format. By default the start date is the date when the schedule is created
.PARAMETER StartHour
    The hour when the scan will start. The hour is an integer from 0 - 23, where 0 represents 12AM, 7 represents 7AM, and 22 represents 10PM
.PARAMETER StartMinute
    The minute when a scan will start. A valid value is an integer from 0 - 59
.PARAMETER Recurrence
    The number of times the scan will be run before it is deactivated. By default no value is set. Value is an integer from 1 - 99
.PARAMETER EndAfterHours
    End a scan after some number of hours. A valid value is from 0 - 119
.PARAMETER EndAfterMins
    End a scan after some number of minutes. A valid value is an integer from 0 to 59
.PARAMETER PauseAfterHours
    Pause a scan after some number of hours. A valid value is from 0 - 119
.PARAMETER PauseAfterMins
    Pause a scan after some number of minutes. A valid value is an integer from 0 - 59
.PARAMETER ResumeInDays
    Resume a paused scan in some number of days. A valid value is an integer from 0 - 9
.PARAMETER ResumeInHours
    Resume a paused scan in some number of hours. A valid value is an integer from 0 - 23
.EXAMPLE
    Set-QualysScanSchedule -Title 'Test Schedule' -AssetGroups 'My Asset Group' -DefaultScanners -Daily 20 -StartDate "03/01/2021" -StartHour 0 -StartMinute 0 -EndAfterHours 0 -EndAfterMins 20 -OptionProfile 'Recommended Standard Scan'
#>

function Set-QualysScanSchedule{
    [CmdletBinding(SupportsShouldProcess)]
    param (
        [Parameter(Mandatory=$true)]
        [String]$Identity,
        [Alias('scan_title')]
        [String]$Title,
        [Parameter(Mandatory=$true)]
        [ValidateRange(0,1)]
        [Alias('active')]
        [Int]$Status,
        [String]$OptionProfile,
        [String[]]$AssetGroups,
        [String]$Scanners,
        [ValidateRange(0,9)]
        [Int]$Priority = 0,
        [ValidateRange(1,365)]
        [Int]$Daily,
        [ValidateRange(1,52)]
        [Int]$Weekly,
        [String]$Weekdays = 'sunday, monday, tuesday, wednesday, thursday, friday, saturday',
        [Alias('start_date')]
        [DateTime]$StartDate,
        [ValidateRange(0,23)]
        [Alias('start_hour')]
        [Int]$StartHour,
        [ValidateRange(0,59)]
        [Alias('start_minute')]
        [Int]$StartMinute,
        [ValidateRange(1,99)]
        [Int]$Recurrence,
        [ValidateRange(0,119)]
        [Alias('end_after')]
        [Int]$EndAfterHours,
        [ValidateRange(0,59)]
        [Alias('end_after_mins')]
        [Int]$EndAfterMins,
        [ValidateRange(0,119)]
        [Alias('pause_after_hours')]
        [Int]$PauseAfterHours,
        [ValidateRange(0,59)]
        [Alias('pause_after_mins')]
        [Int]$PauseAfterMins,
        [ValidateRange(0,9)]
        [Alias('resume_in_days')]
        [Int]$ResumeInDays,
        [ValidateRange(0,23)]
        [Alias('resume_in_hours')]
        [Int]$ResumeInHours
    )

    process{
        if ($PSCmdlet.ShouldProcess("$($Identity)")){
            $RestSplat = @{
                Method = 'POST'
                RelativeURI = 'schedule/scan/'
                Body = @{
                    action = 'update'
                    echo_request = '1'
                    id = $Identity
                }
            }

            if($StartDate){
                $RestSplat.Body['observe_dst'] = 'yes'
                $RestSplat.Body['time_zone_code'] = 'US-IL'
                $RestSplat.Body['set_start_time'] = 1
            }

            If($Daily){
                $RestSplat.Body['occurrence'] = 'daily'
                $RestSplat.Body['frequency_days'] = $Daily
            }

            If($Weekly){
                $RestSplat.Body['occurrence'] = 'weekly'
                $RestSplat.Body['frequency_weeks'] = $Weekly
                $RestSplat.Body['weekdays'] = $Weekdays
            }

            If($AssetGroups){
                If($AssetGroups[0] -match '\D'){
                    $RestSplat.Body['asset_groups'] = (($AssetGroups).Trim() -join ",")
                }
                Else{
                    $RestSplat.Body['asset_group_ids'] = (($AssetGroups).Trim() -join ",")
                }
            }

            If($OptionProfile){
                If($OptionProfile -match '\D'){
                    $RestSplat.Body['option_title'] = $OptionProfile
                }
                Else{
                    $RestSplat.Body['option_id'] = $OptionProfile
                }
            }

            If($Scanners){
                If($Scanners -match '\D'){
                    $RestSplat.Body['iscanner_name'] = $Scanners
                }
                Else{
                    $RestSplat.Body['iscanner_id'] = $Scanners
                }
            }

            If($FQDN){
                $RestSplat.Body['fqdn'] = (($FQDN).Trim() -join ",")
            }

            If($StartDate){
                $RestSplat.Body['start_date'] = $StartDate.ToString("MM/dd/yyyy")
            }

            #Takes any parameter that's set, except excluded ones, and adds one of the same name (or alias name if present) to the API body
            [String[]]$Exclusions = (
                'Daily','TimeZoneCode','Weekly','ExcludeIPs','DefaultScanners', 'AssetGroups',
                'OptionProfile', 'Scanners', 'FQDN', 'StartDate','Identity','Verbose'
            )
            $PSBoundParameters.Keys | Where-Object -FilterScript {($_ -notin $Exclusions) -and $_} | ForEach-Object -Process {
                if($MyInvocation.MyCommand.Parameters[$_].Aliases[0]){
                    [String]$APIKeyNames = $MyInvocation.MyCommand.Parameters[$_].Aliases[0]
                    $RestSplat.Body.$APIKeyNames = $PSBoundParameters[$_]
                }
                else {
                    $RestSplat.Body.$_ = $PSBoundParameters[$_]
                }
            }

            $Response = Invoke-QualysRestCall @RestSplat
            If($Response){
                Write-Verbose -Message $Response.SIMPLE_RETURN.RESPONSE.TEXT
            }
        }
    }
}