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.