bitsadmin addfilewithranges

將文件新增至指定作業。 BITS 從遠端檔案下載指定範圍。 此開關僅對下載作業有效。

語法

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

參數

參數 描述
作業 作業的顯示名稱或 GUID。
remoteURL 伺服器上文件的 URL。
localname 本機上的檔案的名稱。 必須包含文件的絕對路徑。
rangelist 以逗號分隔的 offset:length 對列表。 使用冒號將偏移值與長度值分隔開。 例如,值告訴 0:100,2000:100,5000:eofBITS 從偏移量 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