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.

其他参考