.. highlight:: xml
.. index:: downloadFile

.. _downloadFile:

``downloadFile``
----------------

This task downloads a single file from the device. This task is slightly faster than the :ref:`download` task since it does not need to make a query to determine which files to download. Use this task to download a single file and use :ref:`download` to download multiple files.

Attributes/Options
^^^^^^^^^^^^^^^^^^

.. list-table ::
   :widths: 20 80 8
   :header-rows: 1

   * - Name
     - Description
     - Required 
   * - file
     - Fully qualified path of the file on the device. If the filesystem in the form of ``filesystem:/`` is not specified, it will default to ``local:/``. 
     - Yes
   * - to
     - Local directory or file name where the remote file will be saved. If this is an existing directory, DPBuddy will preserve the file name. Otherwise, DPBuddy will use the value of ``to`` as the new file name.
     - Yes

Examples
^^^^^^^^

This task will save the file to the "dpconfigs" directory:

.. code-block:: xml   

   <dp:download file="pubcert://American-Express-Global-CA.pem" to="dpconfigs" />