bitsadmin addfilewithranges
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