Windows 7 / Getting Started

Managing BITS with Windows PowerShell

Previous versions of Windows provided command-line management of BITS using the BITSAdmin.exe tool. In Windows 7, BITSAdmin.exe is deprecated. Instead, you should use the Windows PowerShell cmdlets.

Within Windows PowerShell, begin by running the following command.

Import-Module BitsTransfer

After you import the BitsTransfer module, the following cmdlets are available:

  • Add-BitsFile Adds files to a BITS transfer
  • Complete-BitsTransfer Completes a BITS transfer
  • Get-BitsTransfer Gets a BITS transfer
  • Remove-BitsTransfer Stops a BITS transfer
  • Resume-BitsTransfer Resumes a suspended BITS transfer
  • Set-BitsTransfer Configures a BITS transfer job
  • Start-BitsTransfer Creates and starts a BITS transfer job
  • Suspend-BitsTransfer Pauses a BITS transfer job

For example, the following Windows PowerShell command begins a BITS transfer from the local computer to a computer named CLIENT.

Start-BitsTransfer -Source file.txt -Destination \\client\share -Priority normal

When running Windows PowerShell interactively, the PowerShell window displays the progress of the transfer. The following command uses an abbreviated notation to download a file from a Web site to the local computer.

Start-BitsTransfer http://server/dir/myfile.txt C:\docs\myfile.txt

For detailed information, run the following command within Windows PowerShell.

Help About_BITS_Cmdlets
[Previous] [Contents] [Next]