powershellscripts.com

Tutorials  PowerShell Cmdlet Help for Resume-BitsTransfer



NAME
Resume-BitsTransfer

SYNOPSIS
Resumes a Background Intelligent Transfer Service (BITS) transfer job.

SYNTAX
Resume-BitsTransfer [-BitsJob] [-Asynchronous] [-Confirm] [-WhatIf] []


DESCRIPTION
The Resume-BitsTransfer cmdlet resumes one or more suspended BITS transfer jobs. If the BITS transfer is already in
process, the cmdlet does nothing. You can view the current state of a transfer job by using the Get-BitsTransfer c
mdlet.

Important: By default, the Resume-BitsTransfer cmdlet restarts the transfer job synchronously even if the original
job was specified as an asynchronous transfer job. You could use this behavior to convert an asynchronous transfer
job into a synchronous transfer job. You could do this if either of the following conditions is true:

- The asynchronous transfer job was created outside cmdlets.
- The asynchronous transfer job was created by using the Start-BitsTransfer cmdlet.

If you want to restart the transfer job as an asynchronous transfer, use the Asynchronous parameter.


PARAMETERS
-Asynchronous []
Allows 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 status and progress.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-BitsJob
Specifies the BITS transfer jobs to resume. You can pipe a value to this parameter from other cmdlets that retu
rn BitsJob objects, such as Get-BitsTransfer.

Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue)
Accept wildcard characters? false

-Confirm []
Prompts you for confirmation before executing the command.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-WhatIf []
Describes what would happen if you executed the command without actually executing the command.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false


This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".

INPUTS
Microsoft.BackgroundIntelligentTransfer.Management.BitsJob[]
This cmdlet accepts one or more BitsJob objects as input that populates the BitsJob parameter.


OUTPUTS
Microsoft.BackgroundIntelligentTransfer.Management.BitsJob[]
When called with the Asynchronous parameter, this cmdlet sends the BitsJob object that is associated with the r
esumed BITS transfer job as output. Otherwise, no output is generated.


NOTES


You can cancel a transfer job that is running in synchronous mode (foreground priority) by pressing CTRL+C.


-------------------------- EXAMPLE 1 --------------------------

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


Description
-----------
This command resumes all the BITS transfer jobs that are owned by the current user.

The command prompt returns after the jobs are complete or after the jobs enter an error state. The output of the Ge
t-BitsTransfer cmdlet is a set of BitsJob objects. This output is piped to the Resume-BitsTransfer cmdlet. If any o
f the BITS transfer jobs are already active, they will continue to run.





-------------------------- EXAMPLE 2 --------------------------

C:\PS>$b = Start-BitsTransfer -DisplayName "MyJob" -Suspended
Add-BitsTransfer -BitsJob $b -ClientFileName C:\myFile -ServerFileName http://www.mysite.com/file1
Resume-BitsTransfer -BitsJob $b -Asynchronous


Description
-----------
This command resumes a new BITS transfer job that was initially suspended, and it returns the command prompt immedi
ately.

The first command creates a new BitsJob object in a suspended state and then stores it in the $b variable.

The second command adds a file to the transfer queue of the new BitsJob object that is stored in the $b variable.

The third command uses the BitsJob parameter to pass the BitsJob object that is stored in the $b parameter to the R
esume-BitsTransfer cmdlet. This command starts the BITS transfer job.





-------------------------- EXAMPLE 3 --------------------------

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


Description
-----------
This command resumes the BITS transfer that is identified by the specified display name.

The command prompt returns after the job is complete or after the job enters an error state. The output of the Get-
BitsTransfer cmdlet is a BitsJob object. This output is piped to the Resume-BitsTransfer cmdlet. If the BITS transf
er job is already active, it will continue to run.






RELATED LINKS
Online version: http://go.microsoft.com/fwlink/?LinkId=141432
Add-BitsFile
Complete-BitsTransfer
Get-BitsTransfer
Remove-BitsTransfer
Set-BitsTransfer
Start-BitsTransfer
Suspend-BitsTransfer