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