bitsadmin addfilewithrangesbitsadmin addfilewithranges

指定したジョブには、ファイルを追加します。Adds a file to the specified job. BITS では、リモート ファイルから指定した範囲をダウンロードします。BITS downloads the specified ranges from the remote file. このスイッチは、ダウンロード ジョブでのみ有効です。This switch is valid only for download jobs.

構文Syntax

bitsadmin /AddFileWithRanges <Job> <RemoteURL> <LocalName> <RangeList>

パラメーターParameters

パラメーターParameter 説明Description
JobJob ジョブの表示名または GUIDThe job's display name or GUID
RemoteURLRemoteURL RemoteURLは、サーバー上のファイルの URL です。RemoteURL is the URL of the file on the server.
LocalNameLocalName LocalNameローカル コンピューター上のファイルの名前を指定します。LocalName is the name of the file on the local computer. LocalNameファイルへの絶対パスを含める必要があります。LocalName must contain an absolute path to the file.
RangeListRangeList RangeListがオフセットの長さ: ペアのコンマ区切りの一覧。RangeList is a comma-delimited list of offset:length pairs. コロンを使用して、長さの値からオフセット値を区切ります。Use a colon to separate the offset value from the length value. たとえばの値0:100,2000:100,5000:eofからのオフセット 0、100 バイト オフセット 2000 から 100 バイトが転送には BITS を指示しから残りのバイト オフセット、ファイルの末尾に 5000 です。For example, a value of 0:100,2000:100,5000:eof tells BITS to transfer 100 bytes from offset 0, 100 bytes from offset 2000, and the remaining bytes from offset 5000 to the end of the file.

詳細情報More Information

  • トークンeofオフセットと長さのペア内で有効な長さの値は、 <RangeList > します。The token eof is a valid length value within the offset and length pairs in the <RangeList>. サービスを指定したファイルの末尾まで読み取るように指示します。It instructs the service to read to the end of the specified file.

  • 長さ 0 の範囲を指定すると共に、同じオフセットは、別の範囲など AddFileWithRanges が失敗しエラー コード 0x8020002c ことに注意してください。C:\bits > bitsadmin/addfilewithranges j2 http://bitsdc/dload/1k.zip c:\1k.zip 100:0、100:5Note that AddFileWithRanges will fail with error code 0x8020002c when a zero-length range is specified along with another range with same offset, such as: C:\bits>bitsadmin /addfilewithranges j2 http://bitsdc/dload/1k.zip c:\1k.zip 100:0,100:5

    エラー メッセージ:ジョブ - 0x8020002c にファイルを追加できません。Error message: Unable to add file to job - 0x8020002c. バイト範囲の一覧には、サポートされていない、重複する範囲が含まれています。The list of byte ranges contains some overlapping ranges, which are not supported.

    回避策: は、長さ 0 の範囲を最初は指定できません。Workaround: do not specify the zero-length range first. 例: bitsadmin/addfilewithranges j2 http://bitsdc/dload/1k.zip c:\1k.zip 100:5、100:0 します。For example: bitsadmin /addfilewithranges j2 http://bitsdc/dload/1k.zip c:\1k.zip 100:5,100:0.

Examples

次の例からのオフセット 0、100 バイト オフセットの 2000 から 100 バイトが転送には BITS およびから残りのバイト オフセット 5000 ファイルの末尾にします。The following example tells BITS to transfer 100 bytes from offset 0, 100 bytes from offset 2000, and the remaining bytes from offset 5000 to the end of the file.

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

その他の参照情報Additional references

コマンド ライン構文の記号Command-Line Syntax Key