Resume-BitsTransfer

Resume-BitsTransfer

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

구문

Parameter Set: Default
Resume-BitsTransfer [-BitsJob] <BitsJob[]> [-Asynchronous] [-Confirm] [-WhatIf] [ <CommonParameters>]

자세한 설명

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 cmdlet.

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.

매개 변수

-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.

-BitsJob<BitsJob[]>

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

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

<CommonParameters>

이 cmdlet은 일반 매개 변수 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer 및 -OutVariable을 지원합니다. 자세한 내용은 다음을 참조하세요. about_CommonParameters(https://go.microsoft.com/fwlink/p/?LinkID=113216).

입력

입력 유형은 cmdlet에 파이프할 수 있는 개체의 유형입니다.

• Microsoft.BackgroundIntelligentTransfer.Management.BitsJob[]

  This cmdlet accepts one or more BitsJob objects as input that populates the BitsJob parameter.

출력

출력 유형은 cmdlet이 내보내는 개체의 유형입니다.

• Microsoft.BackgroundIntelligentTransfer.Management.BitsJob[]

  When called with the Asynchronous parameter, this cmdlet sends the BitsJob object that is associated with the resumed BITS transfer job as output. Otherwise, no output is generated.

참고

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

예제

EXAMPLE 1

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 Get-BitsTransfer cmdlet is a set of BitsJob objects. This output is piped to the Resume-BitsTransfer cmdlet. If any of the BITS transfer jobs are already active, they will continue to run.

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

EXAMPLE 2

This command resumes a new BITS transfer job that was initially suspended, and it returns the command prompt immediately.

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 Resume-BitsTransfer cmdlet. This command starts the BITS transfer job.

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

EXAMPLE 3

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 transfer job is already active, it will continue to run.

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

관련 항목

Add-BitsFile

Complete-BitsTransfer

Get-BitsTransfer

Remove-BitsTransfer

Set-BitsTransfer

Start-BitsTransfer

Suspend-BitsTransfer