bitsadmin addfilewithranges

Agrega un archivo al trabajo especificado. BITS descarga los intervalos especificados desde el archivo remoto. Este conmutador solo es válido para trabajos de descarga.

Sintaxis

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

Parámetros

Parámetro Descripción
trabajo El nombre para mostrar o GUID del trabajo.
remoteURL Dirección URL del archivo en el servidor.
localname Nombre del archivo del equipo local. Debe contener una ruta de acceso absoluta al archivo.
rangelist Lista delimitada por comas de pares offset:length. Use dos puntos para separar el valor de desplazamiento del valor de longitud. Por ejemplo, un valor de 0:100,2000:100,5000:eof indica a BITS que transfiera 100 bytes del desplazamiento 0, 100 bytes del desplazamiento 2000 y los bytes restantes del desplazamiento 5000 al final del archivo.

Comentarios

  • El token eof es un valor de longitud válido dentro de los pares de desplazamiento y longitud en <rangelist>. Indica al servicio que lea al final del archivo especificado.

  • El comando addfilewithranges producirá un error con el código 0x8020002c, si se especifica un intervalo de longitud cero junto con otro intervalo con el mismo desplazamiento, como:

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

    Mensaje de error: no se puede agregar el archivo al trabajo: 0x8020002c. La lista de intervalos de bytes contiene algunos intervalos superpuestos que no se admiten.

    Solución: no especifique primero el intervalo de longitud cero. Por ejemplo, use bitsadmin /addfilewithranges j2 http://bitsdc/dload/1k.zip c:\1k.zip 100:5,100:0.

Ejemplos

Para transferir 100 bytes del desplazamiento 0, 100 bytes del desplazamiento 2000 y los bytes restantes del desplazamiento 5000 al final del archivo:

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