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 PowerShell Cmdlets:
Complete-BitsTransfer - Complete a BITS transfer.
Set-BitsTransfer - Configure BITS transfer jobs.
BITS PowerShell cmdlets