bitsadmin addfilewithranges

  • Artikel

Fügt dem angegebenen Auftrag eine Datei hinzu. BITS lädt die angegebenen Bereiche aus der Remotedatei herunter. Diese Option ist nur für Downloadaufträge gültig.

Syntax

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

Parameter

Parameter BESCHREIBUNG
Auftrag Der Anzeigename oder die GUID des Auftrags.
remoteURL URL der Datei auf dem Server.
localname Name der Datei auf dem lokalen Computer. Muss einen absoluten Pfad zur Datei enthalten.
rangelist Durch Trennzeichen getrennte Liste von offset:length-Paaren. Verwenden Sie einen Doppelpunkt, um den Offsetwert vom Längenwert zu trennen. Ein Wert von 0:100,2000:100,5000:eof weist z.–B. BITS an, 100 Bytes vom Offset 0, 100 Bytes vom Offset 2000 und die restlichen Bytes vom Offset 5000 an das Ende der Datei zu übertragen.

Hinweise

  • Das Token eof ist ein gültiger Längenwert innerhalb der Offset- und Längenpaare in <rangelist>. Es weist den Dienst an, bis zum Ende der angegebenen Datei zu lesen.

  • Der Befehl addfilewithranges schlägt mit dem Fehlercode 0x8020002c fehl, wenn ein Bereich der Länge Null zusammen mit einem anderen Bereich angegeben wird, der denselben Offset verwendet, z. B.:

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

    Fehlermeldung: Die Datei kann nicht zum Auftrag hinzugefügt werden – 0x8020002c. Die Liste der Bytebereiche enthält einige überlappende Bereiche, die nicht unterstützt werden.

    Problemumgehung: Geben Sie nicht zuerst den Bereich mit der Länge Null an. Verwenden Sie beispielsweise bitsadmin /addfilewithranges j2 http://bitsdc/dload/1k.zip c:\1k.zip 100:5,100:0.

Beispiele

So übertragen Sie 100 Bytes von Offset 0, 100 Bytes aus Offset 2000 und die restlichen Bytes von Offset 5000 an das Ende der Datei:

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