bitsadmin addfilewithranges

Fügt dem angegebenen Auftrag eine Datei hinzu. BITS lädt die angegebenen Bereiche aus der Remotedatei herunter. Dieser Schalter 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. Der Wert 0:100,2000:100,5000:eof weist BITS beispielsweise an, 100 Bytes vom Offset 0, 100 Bytes vom Offset 2000 und die verbleibenden Bytes von Offset 5000 an das Ende der Datei zu übertragen.

Bemerkungen

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

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

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

    Fehlermeldung: Dem Auftrag kann keine Datei 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 der Länge 0 (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 vom Offset 0, 100 Bytes vom Offset 2000 und die verbleibenden Bytes von Offset 5000 an das Ende der Datei:

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

Weitere Verweise