Bitsadmin /transfer

  • Article

 

Applies To: Windows Vista, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012, Windows 8

Transfers one or more files.

Syntax

bitsadmin /Transfer Name [Type] [/Priority Job_Priority] [/ACLFlags Flags] <RemoteFileName> <LocalFileName>

Parameters

Parameter

Description

Name

The name of the job.

Type

Optional—specify the type of job. Use /Download for a download job or /Upload for an upload job.

Priority

Optional— set the job_priority to one of the following values:

  • FOREGROUND

  • HIGH

  • NORMAL

  • LOW

ACLFlags

Specify one or more of the following flags:

  • O: Copy owner information with file.

  • G: Copy group information with file.

  • D: Copy DACL information with file.

  • S: Copy SACL information with file.

RemoteFileName

The name of the file when transferred to the server

LocalFileName

The name of the file that resides locally.

Remarks

By default, the BITSAdmin service creates a download job that runs at NORMAL priority and updates the command window with progress information until the transfer is complete or until a critical error occurs. The service completes the job if it successfully transfers all the files and cancels the job if a critical error occurs. The service does not create the job if it is unable to add files to the job or if you specify an invalid value for Type or Job_Priority. To transfer more than one file, specify multiple RemoteFileName-LocalFileName pairs. The pairs are space-delimited.

Note

The BITSAdmin command continues to run if a transient error occurs. To end the command, press CTRL+C.

Examples

The following example starts a transfer job with named myDownloadJob.

C:\>bitsadmin /Transfer myDownloadJob https://prodserver/audio.wma c:\downloads\audio.wma

Additional references

Command-Line Syntax Key