大网数据广告活动
Windows排障命令

bitsadmin addfilewithranges

· 52CE 我爱测

Reference article for the bitsadmin addfilewithranges command, which adds a file to the specified job. BITS downloads the specified ranges from the remote file.

Adds a file to the specified job. BITS downloads the specified ranges from the remote file. This switch is valid only for download jobs.

Syntax

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

Parameters

Parameter Description
job The job's display name or GUID.
remoteURL URL of the file on the server.
localname Name of the file on the local computer. Must contain an absolute path to the file.
rangelist Comma-delimited list of offset:length pairs. Use a colon to separate the offset value from the length value. For example, a value of 0:100,2000:100,5000:eof tells BITS to transfer 100 bytes from offset 0, 100 bytes from offset 2000, and the remaining bytes from offset 5000 to the end of the file.

Remarks

  • The token eof is a valid length value within the offset and length pairs in the <rangelist>. It instructs the service to read to the end of the specified file.

  • The addfilewithranges command will fail with error code 0x8020002c, if a zero-length range is specified along with another range using same offset, such as:

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

    Error message: Unable to add file to job - 0x8020002c. The list of byte ranges contains some overlapping ranges, which are not supported.

    Workaround: Don't specify the zero-length range first. For example, use bitsadmin /addfilewithranges j2 http://bitsdc/dload/1k.zip c:\1k.zip 100:5,100:0

Examples

To transfer 100 bytes from offset 0, 100 bytes from offset 2000, and the remaining bytes from offset 5000 to the end of the file:

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

Related links

Source: Microsoft Learn / Windows Server documentation by Microsoft and contributors (upstream author metadata: robinharwood). Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.

资料来源与适用范围

资料来源
Microsoft Learn / Windows Server documentation
适用范围
Windows Server · Source date 10/16/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0 (documentation), MIT (code samples)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。