bitsadmin addfilewithranges

  • Article

Ajoute un fichier au travail spécifié. BITS télécharge les plages spécifiées à partir du fichier distant. Ce commutateur est valide uniquement pour les travaux de téléchargement.

Syntaxe

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

Paramètres

Paramètre Description
travail Nom complet ou GUID du travail.
remoteURL URL du fichier sur le serveur.
localname Nom du fichier sur l’ordinateur local. Doit contenir un chemin absolu au fichier.
rangelist Liste délimitée par des virgules de paires décalage:longueur. Utilisez un signe deux-points pour séparer la valeur de décalage de la valeur de longueur. Par exemple, la valeur 0:100,2000:100,5000:eof indique à BITS de transférer 100 octets à partir du décalage 0, 100 octets à partir du décalage 2000 et les octets restants à partir du décalage 5000 jusqu’à la fin du fichier.

Notes

  • Le jeton eof est une valeur de longueur valide dans les paires de décalage-longueur dans <rangelist>. Il indique au service de lire jusqu’à la fin du fichier spécifié.

  • La commande addfilewithranges échoue avec le code d’erreur 0x8020002c, si une plage de longueur nulle est spécifiée avec une autre plage utilisant le même décalage, par exemple :

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

    Message d’erreur : Impossible d’ajouter le fichier au travail - 0x8020002c. La liste de plages d’octets contient des plages qui se chevauchent, ce qui n’est pas pris en charge.

    Solution de contournement : ne spécifiez pas la plage de longueur nulle en premier. Par exemple, utilisez bitsadmin /addfilewithranges j2 http://bitsdc/dload/1k.zip c:\1k.zip 100:5,100:0

Exemples

Pour transférer 100 octets à partir du décalage 0, 100 octets à partir du décalage 2000 et les octets restants à partir du décalage 5000 jusqu’à la fin du fichier :

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