bitsadmin addfilewithranges
指定されたジョブにファイルを追加します。 BITS は、指定された範囲をリモート ファイルからダウンロードします。 このスイッチは、ダウンロード ジョブにのみ有効です。
構文
bitsadmin /addfilewithranges <job> <remoteURL> <localname> <rangelist>
パラメーター
| パラメーター | 説明 |
|---|---|
| ジョブ (job) | ジョブの表示名または GUID。 |
| remoteURL | サーバー上のファイルの URL。 |
| localname | ローカル コンピューター上のファイルの名前。 ファイルへの絶対パスを含む必要があります。 |
| rangelist | offset:length ペアのコンマ区切りのリスト。 コロンを使用して、オフセット値と長さの値を区切ります。 たとえば、0:100,2000:100,5000:eof の値は、オフセット 0 から 100 バイト、オフセット 2000 から 100 バイト、およびオフセット 5000 からファイルの末尾への残りのバイトを転送するよう BITS に指示します。 |
解説
トークン eof は、
<rangelist>のオフセットと長さのペア内の有効な長さの値です。 指定したファイルの末尾まで読み取るようサービスに指示します。長さ 0 の範囲が、同じオフセットを使用する別の範囲と共に指定されている場合、
addfilewithrangesコマンドは次のようなエラー コード 0x8020002c で失敗します。c:\bits>bitsadmin /addfilewithranges j2 http://bitsdc/dload/1k.zip c:\1k.zip 100:0,100:5エラー メッセージ: ジョブにファイルを追加できません - 0x8020002c。 バイト範囲の一覧に、重複する範囲が含まれています。これはサポートされていません。
回避策: 長さ 0 の範囲を最初に指定しないでください。 たとえば、
bitsadmin /addfilewithranges j2 http://bitsdc/dload/1k.zip c:\1k.zip 100:5,100:0を使用します
例
オフセット 0 から 100 バイト、オフセット 2000 からの 100 バイト、およびオフセット 5000 からファイルの末尾への残りのバイトを転送するには:
bitsadmin /addfilewithranges http://downloadsrv/10mb.zip c:\10mb.zip 0:100,2000:100,5000:eof