bitsadmin 示例

以下示例演示如何使用 bitsadmin 工具执行最常见的任务。

传输文件

若要创建作业,请添加文件,激活传输队列中的作业,然后完成该作业:

bitsadmin /transfer myDownloadJob /download /priority normal https://downloadsrv/10mb.zip c:\\10mb.zip

BITSAdmin 继续在 MS-DOS 窗口中显示进度信息,直到传输完成或发生错误。

创建下载作业

若要创建名为 myDownloadJob 下载作业:

bitsadmin /create myDownloadJob

BITSAdmin 返回唯一标识作业的 GUID。 在后续调用中使用 GUID 或作业名称。 以下文本是示例输出。

示例输出

created job {C775D194-090F-431F-B5FB-8334D00D1CB6}

将文件添加到下载作业

若要向作业添加文件,请执行以下作:

bitsadmin /addfile myDownloadJob https://downloadsrv/10mb.zip c:\\10mb.zip

对要添加的每个文件重复此调用。 如果多个作业使用 myDownloadJob 作为其名称,则必须使用作业的 GUID 来唯一标识它以完成。

激活下载作业

创建新作业后,BITS 会自动挂起该作业。 若要在传输队列中激活作业,请执行以下作:

bitsadmin /resume myDownloadJob

如果多个作业使用 myDownloadJob 作为其名称,则必须使用作业的 GUID 来唯一标识它以完成。

确定下载作业的进度

/info 开关返回作业的状态以及传输的文件数和字节数。 当状态显示为 TRANSFERRED时,这意味着 BITS 已成功传输作业中的所有文件。 还可以添加 /verbose 参数以获取作业的完整详细信息,/list/monitor 获取传输队列中的所有作业。

返回作业的状态:

bitsadmin /info myDownloadJob /verbose

如果多个作业使用 myDownloadJob 作为其名称,则必须使用作业的 GUID 来唯一标识它以完成。

完成下载作业

若要在状态更改为 TRANSFERRED后完成作业:

bitsadmin /complete myDownloadJob

在作业中的文件可用之前,必须运行 /complete 开关。 如果多个作业使用 myDownloadJob 作为其名称,则必须使用作业的 GUID 来唯一标识它以完成。

使用 /list 开关监视传输队列中的作业

若要返回作业的状态以及传输队列中所有作业传输的文件和字节数:

bitsadmin /list

示例输出

{6AF46E48-41D3-453F-B7AF-A694BBC823F7} job1 SUSPENDED 0 / 0 0 / 0
{482FCAF0-74BF-469B-8929-5CCD028C9499} job2 TRANSIENT_ERROR 0 / 1 0 / UNKNOWN

Listed 2 job(s).

使用 /monitor 开关监视传输队列中的作业

若要返回作业的状态以及传输队列中所有作业传输的文件和字节数,请每隔 5 秒刷新一次数据:

bitsadmin /monitor

注释

若要停止刷新,请按 Ctrl+C。

示例输出

MONITORING BACKGROUND COPY MANAGER(5 second refresh)
{6AF46E48-41D3-453F-B7AF-A694BBC823F7} job1 SUSPENDED 0 / 0 0 / 0
{482FCAF0-74BF-469B-8929-5CCD028C9499} job2 TRANSIENT_ERROR 0 / 1 0 / UNKNOWN
{0B138008-304B-4264-B021-FD04455588FF} job3 TRANSFERRED 1 / 1 100379370 / 100379370

使用 /info 开关监视传输队列中的作业

返回作业的状态以及传输的文件数和字节数:

bitsadmin /info

示例输出

GUID: {482FCAF0-74BF-469B-8929-5CCD028C9499} DISPLAY: myDownloadJob
TYPE: DOWNLOAD STATE: TRANSIENT_ERROR OWNER: domain\user
PRIORITY: NORMAL FILES: 0 / 1 BYTES: 0 / UNKNOWN
CREATION TIME: 12/17/2002 1:21:17 PM MODIFICATION TIME: 12/17/2002 1:21:30 PM
COMPLETION TIME: UNKNOWN
NOTIFY INTERFACE: UNREGISTERED NOTIFICATION FLAGS: 3
RETRY DELAY: 600 NO PROGRESS TIMEOUT: 1209600 ERROR COUNT: 0
PROXY USAGE: PRECONFIG PROXY LIST: NULL PROXY BYPASS LIST: NULL
ERROR FILE:    https://downloadsrv/10mb.zip -> c:\10mb.zip
ERROR CODE:    0x80072ee7 - The server name or address could not be resolved
ERROR CONTEXT: 0x00000005 - The error occurred while the remote file was being
processed.
DESCRIPTION:
JOB FILES:
0 / UNKNOWN WORKING https://downloadsrv/10mb.zip -> c:\10mb.zip
NOTIFICATION COMMAND LINE: none

从传输队列中删除作业

若要从传输队列中删除所有作业,请使用 /reset 开关:

bitsadmin /reset

示例输出

{DC61A20C-44AB-4768-B175-8000D02545B9} canceled.
{BB6E91F3-6EDA-4BB4-9E01-5C5CBB5411F8} canceled.
2 out of 2 jobs canceled.