Resume-BitsTransfer

Resume a Background Intelligent Transfer Service (BITS) transfer job.

Syntax
      Resume-BitsTransfer [-BitsJob] BitsJob[] [-Asynchronous]
         [-Confirm] [-WhatIf] [CommonParameters]

Key
   -BitsJob BitsJob[]
       The BITS transfer job(s) to resume.
       Pipe a value to this parameter from other cmdlets that return BitsJob objects, such as Get-BitsTransfer.

   -Asynchronous
       Allow the BITS transfer job to be processed in the background.
       The command prompt reappears immediately after the BITS transfer job is resumed.
       The returned BitsJob object can be used to monitor job status and progress.

   -Confirm
       Prompt for confirmation before executing the command.

   -WhatIf
       Describe what would happen if you executed the command, without actually executing the command.

   CommonParameters:
       -Verbose, -Debug, -ErrorAction, -ErrorVariable, -WarningAction, -WarningVariable,
       -OutBuffer -OutVariable.

Resume-BitsTransfer resumes one or more suspended BITS transfer jobs. If the BITS transfer is already in process, the cmdlet does nothing.
View the current state of a transfer job with Get-BitsTransfer.

By default, Resume-BitsTransfer restarts the transfer job synchronously even if the original job was specified as an asynchronous transfer job. to restart the transfer job as an asynchronous transfer, use the -Asynchronous parameter. This behavior may be used to convert an asynchronous transfer job into a synchronous transfer job.

Examples

Resume all the BITS transfer jobs that are owned by the current user:

PS C:\> Get-BitsTransfer | Resume-BitsTransfer

Resume the BITS transfer job called AppPatchesMarch:

PS C:\> Get-BitsTransfer -Name AppPatchesMarch | Resume-BitsTransfer

Create a new BITS transfer job (suspended) add a file to it, and then resume the job:

PS C:\> $newJob = Start-BitsTransfer -DisplayName "SS64Job" -Suspended
PS C:\> Add-BitsTransfer -BitsJob $newJob -ClientFileName C:\demo\file1.txt -ServerFileName http://example.com/file1.txt
PS C:\> Resume-BitsTransfer -BitsJob $newJob -Asynchronous

“The people when rightly and fully trusted will return the trust” ~ Abraham Lincoln

Related:

Complete-BitsTransfer - Complete a BITS transfer
Set-BitsTransfer - Configure BITS transfer jobs
BITS PowerShell cmdlets


© Copyright SS64.com 1999-2013
Some rights reserved