Send-RtrGet.psm1

function Send-RtrGet {
<#
    .SYNOPSIS
        Batch executes 'get' command across hosts to retrieve files. After this call is made
        'Confirm-RtrGetFile' is used to query for the results

    .PARAMETER ID
        Batch ID to execute the command on

    .PARAMETER PATH
        Full path to the file that is to be retrieved from each host in the batch

    .PARAMETER TIMEOUT
        Time to wait for the command request in seconds [default: 30, maximum 600]

    .PARAMETER OPTIONAL
        List of a subset of hosts we want to run the command on. If this list is supplied, only
        these hosts will receive the command
#>
    [CmdletBinding()]
    [OutputType([psobject])]
    param(
        [Parameter(Mandatory = $true)]
        [ValidateLength(36,36)]
        [string]
        $Id,

        [string]
        $Path,

        [ValidateRange(30,600)]
        [int]
        $Timeout = 30,

        [array]
        $Optional
    )
    process{
        $Param = @{
            Uri = '/real-time-response/combined/batch-get-command/v1?timeout=' + [string] $Timeout
            Method = 'post'
            Header = @{
                accept = 'application/json'
                'content-type' = 'application/json'
            }
            Body = @{
                batch_id = $Id
                file_path = $Path
            }
        }
        switch ($PSBoundParameters.Keys) {
            'Optional' { $Param.Body['optional_hosts'] = $Optional }
            'Verbose' { $Param['Verbose'] = $true }
            'Debug' { $Param['Debug'] = $true }
        }
        $Param.Body = $Param.Body | ConvertTo-Json

        Invoke-CsAPI @Param
    }
}