PowerShell Logo Small

Get-BitsTransfer



This is the built-in help made by Microsoft for the command 'Get-BitsTransfer', in PowerShell version 3 - as retrieved from Windows version 'Microsoft Windows Server 2012 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Retrieves the associated BitsJob object for an existing Background Intelligent Transfer Service (BITS) transfer job.

SYNTAX


Get-BitsTransfer [[-Name] <string[]>] [[-AllUsers]] [<CommonParameters>]
Get-BitsTransfer [-JobId] <Guid[]> [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Get-BitsTransfer cmdlet retrieves a set of BITS transfer jobs. By default, the cmdlet returns the jobs that are owned by the current user.
However, if you have administrative credentials, you can specify the AllUsers parameter so that the command returns jobs that are owned by
all users. The returned jobs can be filtered by name or ID. The jobs are represented by BitsJob objects.



<

RELATED LINKS

Online version: http://go.microsoft.com/fwlink/?LinkId=141429
Add-BitsFile
Complete-BitsTransfer
Remove-BitsTransfer
Resume-BitsTransfer
Set-BitsTransfer
Start-BitsTransfer
Suspend-BitsTransfer

REMARKS

<

Examples


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

C:\PS>Get-BitsTransfer

JobId DisplayName TransferType JobState OwnerAccount
----- ----------- ------------ -------- ------------
07acbe90-7d25-4d05-a... TestJob2 Download Suspended DOMAIN01\user01
c0dd3d8c-c3a2-4562-8... TestJob1 Download Transferred DOMAIN01\user01
1ef8c549-7a92-4173-b... BitsJobTransfer Download Transferred DOMAIN01\user01
2c8302d5-3f44-4981-8... BitsJobTransfer Download Transferred DOMAIN01\user01



Description

-----------

This command returns all the BitsJob objects that are owned by the current user.








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

C:\PS>Get-BitsTransfer -JobId C0DD3D8C-C3A2-4562-80B19224879C

JobId DisplayName TransferType JobState OwnerAccount
----- ----------- ------------ -------- ------------
c0dd3d8c-c3a2-4562-8... TestJob1 Download Transferred DOMAIN01\user01



Description

-----------

This command returns the BitsJob object that is identified by the specified job ID.








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

C:\PS>Get-BitsTransfer -AllUsers -Name *Microsoft*, *Windows*

JobId DisplayName TransferType JobState OwnerAccount
----- ----------- ------------ -------- ------------
07acbe90-7d25-4d05-a... MicrosoftTest Download Suspended DOMAIN01\user01
c0dd3d8c-c3a2-4562-8... WindowsTest Download Transferred DOMAIN01\user02



Description

-----------

This command returns all the BitsJob objects, owned by all users, where the DisplayName property of the BitsJob object contains either
"Microsoft" or "Windows". If the user does not have administrative credentials, this command returns an error because it uses the AllUsers
parameter.








-------------------------- EXAMPLE 4 --------------------------

C:\PS>Get-BitsTransfer -Name testjob1

JobId DisplayName TransferType JobState OwnerAccount
----- ----------- ------------ -------- ------------
c0dd3d8c-c3a2-4562-8... TestJob1 Download Transferred DOMAIN01\user01



Description

-----------

This command returns the BitsJob object that is identified by the specified display name.