bitsadmin addfilewithranges
向指定作业中添加文件。 BITS 可从远程文件下载指定的范围。 此开关仅适用于下载作业。
语法
bitsadmin /addfilewithranges <job> <remoteURL> <localname> <rangelist>
参数
| 参数 | 说明 |
|---|---|
| 作业 (job) | 该作业的显示名称或 GUID。 |
| remoteURL | 服务器上的文件的 URL。 |
| localname | 本地计算机上的文件的名称。 必须包含文件的绝对路径。 |
| rangelist | 以逗号分隔的 offset:length 对列表。 须使用冒号将偏移值与长度值分开。 例如，值 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