product icon

How to Distribute Files in Remote Execution

    Send files from your computer to multiple remote computers without user interaction.

    Before you begin:

    What's the difference between 'copying' and 'distributing' files?

    The main difference is the source of the files, in other words from where you want to copy files. When you need to copy files from your own computer to target computers, you can distribute files. When you want to copy files on the target computer from one folder to another, you can copy files.

    Important: To use this feature, the user must be authenticated with zero trust authentication, which serves the security of the session.

    Authentication is required only once when you run a Remote Execution step.

    1. On the Remote Execution page, select Create new job.

      Result: The Create job page is displayed.

    2. Choose the platform where you want to run automation steps.
    3. Add the File distribution step to the list on the left.
    4. Click Upload to select the file(s) you want to distribute.
      Note: You can reference the file(s) from the script. You can upload up to three files per job with a maximum size of 1GB each. Any file can be used.
    5. Set the Destination Folder.
    6. Under Overwrite existing files, choose whether to overwrite files that already exist on remote computers.
    7. Click Next.
    8. From the list of Devices define the devices or a group of devices that will receive the script.
      You can organize your devices by selecting a grouping option from the top of the list.
    9. Click Next.
    10. Name the job in a way that is easy to remember later on.
      Optionally, you can schedule jobs up to seven days in advance. To do so, toggle Schedule this job and set the time and date for the job to run.
    11. Click Run.
      Note: A preset timeout pertains to both the job and the step.

      A timeout for every step is set to two hours, meaning that GoTo Resolve waits two hours for the script to finish on the remote computer. When the script finishes, GoTo Resolve starts the next step and waits another two hours for that step to finish. If a step does not finish on a remote computer in two hours, then it times out and the whole job fails.

    Results:
    Note:

    When you reference a file from the script, you only have to enter its name. Once the step ends, the file is deleted from the remote computer, unless it is copied somewhere else with the script.

    Example:

    You upload 'a.txt' file for the job and you would like to copy it into a folder (also known as file distribution). Your script should look something like this:
    Copy-Item a.txt C:\Destination
    Article last updated: 21 July, 2022