bitsadmin addfilewithranges

将文件添加到指定的作业。 BITS 从远程文件下载指定的范围。 此开关仅适用于下载作业。

语法

bitsadmin /addfilewithranges <job> <remoteURL> <localname> <rangelist>

参数

参数 说明
作业 作业的显示名称或 GUID。
remoteURL 服务器上的文件的 URL。
localname 本地计算机上的文件的名称。 必须包含文件的绝对路径。
rangelist 偏移量:长度对的逗号分隔列表。 使用冒号将偏移值与长度值分开。 例如,0:100,2000:100,5000:eof 的值指示 BITS 从偏移量 0、100 字节从偏移量 2000 传输 100 字节,并将剩余字节从偏移量 5000 传输到文件末尾。

注解

  • 标记 eof<rangelist>中偏移量和长度对内的有效长度值。 它指示服务读取到指定文件的末尾。

  • 如果指定零长度范围以及使用相同偏移量的另一个范围,则 addfilewithranges 命令将失败,错误代码为 0x8020002c,例如:

    c:\bits>bitsadmin /addfilewithranges j2 http://bitsdc/dload/1k.zip c:\1k.zip 100:0,100:5

    错误消息: 无法将文件添加到作业 - 0x8020002c。 字节范围列表包含一些不支持的重叠范围。

    解决方法: 不要先指定零长度范围。 例如,使用 bitsadmin /addfilewithranges j2 http://bitsdc/dload/1k.zip c:\1k.zip 100:5,100:0

例子

若要从偏移量 0、100 字节从偏移量 2000 传输 100 字节,并将其余字节从偏移量 5000 传输到文件末尾:

bitsadmin /addfilewithranges http://downloadsrv/10mb.zip c:\10mb.zip 0:100,2000:100,5000:eof