bitsadmin addfilewithranges

  • Статья

Добавляет файл в указанное задание. BITS загружает указанные диапазоны из удаленного файла. Этот параметр действителен только для заданий загрузки.

Синтаксис

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

Параметры

Параметр Описание
задание Отображаемое имя задания или GUID.
remoteURL URL-адрес файла на сервере.
localname Имя файла на локальном компьютере. Должен содержать абсолютный путь к файлу.
список диапазонов Список пар offset:length с разделителями-запятыми. Используйте двоеточие для разделения значения смещения от значения длины. Например, значение 0:100,2000:100,5000:eof BITS сообщает BITS передавать 100 байт из смещения 0, 100 байт от смещения 2000, а остальные байты от смещения 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.

Примеры

Чтобы передать 100 байт из смещения 0, 100 байтов от смещения 2000 и оставшихся байтов от смещения 5000 до конца файла:

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