bitsadmin addfilewithranges

Adiciona um arquivo ao trabalho especificado. O BITS baixa os intervalos especificados do arquivo remoto. Essa alternância é válida apenas para trabalhos de download.

Sintaxe

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

Parâmetros

Parâmetro Descrição
trabalho O nome de exibição do trabalho ou o GUID.
remoteURL URL do arquivo no servidor.
localname Nome do arquivo no computador local. Deve conter um caminho absoluto para o arquivo.
rangelist Lista delimitada por vírgulas de pares offset:length. Use dois-pontos para separar o valor de deslocamento do valor de comprimento. Por exemplo, um valor de 0:100,2000:100,5000:eof informa ao BITS para transferir 100 bytes do deslocamento 0, 100 bytes do deslocamento 2.000 e os bytes restantes do deslocamento de 5.000 para o final do arquivo.

Comentários

  • O token eof é um valor de comprimento válido dentro dos pares de deslocamento e comprimento no <rangelist>. Ele instrui o serviço a ler até o final do arquivo especificado.

  • O comando addfilewithranges falhará com o código de erro 0x8020002c, se um intervalo de comprimento zero for especificado junto com outro intervalo usando o mesmo deslocamento, como:

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

    Mensagem de erro: não é possível adicionar arquivo ao trabalho – 0x8020002c. A lista de intervalos de bytes contém alguns intervalos sobrepostos, que não têm suporte.

    Solução alternativa: não especifique o intervalo de comprimento zero primeiro. Por exemplo, use bitsadmin /addfilewithranges j2 http://bitsdc/dload/1k.zip c:\1k.zip 100:5,100:0

Exemplos

Para transferir 100 bytes do deslocamento 0, 100 bytes do deslocamento 2.000 e os bytes restantes do deslocamento de 5.000 para o final do arquivo:

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