bitsadmin の例

次の例は、bitsadmin ツールを使用して最も一般的なタスクを実行する方法を示しています。

ファイルを転送する

ジョブを作成するには、ファイルを追加し、転送キューでジョブをアクティブ化して、ジョブを完了します。

bitsadmin /transfer myDownloadJob /download /priority normal https://downloadsrv/10mb.zip c:\\10mb.zip

BITSAdmin は、転送が完了するかエラーが発生するまで、MS-DOS ウィンドウに進行状況情報を引き続き表示します。

ダウンロード ジョブを作成する

myDownloadJob という名前のダウンロード ジョブを作成するには、次のように入力します。

bitsadmin /create myDownloadJob

BITSAdmin は、ジョブを一意に識別する GUID を返します。 後続の呼び出しでは、GUID またはジョブ名を使用します。 次のテキストはサンプル出力です。

サンプル出力

created job {C775D194-090F-431F-B5FB-8334D00D1CB6}

ダウンロード ジョブにファイルを追加する

ジョブにファイルを追加するには、次のように入力します。

bitsadmin /addfile myDownloadJob https://downloadsrv/10mb.zip c:\\10mb.zip

追加するファイルごとにこの呼び出しを繰り返します。 複数のジョブで myDownloadJob を名前として使用する場合は、ジョブの GUID を使用して、完了のために一意に識別する必要があります。

ダウンロード ジョブをアクティブ化する

新しいジョブを作成すると、BITS によってジョブが自動的に中断されます。 転送キューでジョブをアクティブにするには:

bitsadmin /resume myDownloadJob

複数のジョブで myDownloadJob を名前として使用する場合は、ジョブの GUID を使用して、完了のために一意に識別する必要があります。

ダウンロード ジョブの進行状況を確認する

/info スイッチは、ジョブの状態と、転送されたファイルとバイト数を返します。 状態が TRANSFERRED と表示されている場合は、BITS によってジョブ内のすべてのファイルが正常に転送されたことを意味します。 /verbose 引数を追加してジョブの詳細を取得し、/list または /monitor を追加して転送キュー内のすべてのジョブを取得できます。

ジョブの状態を返す方法:

bitsadmin /info myDownloadJob /verbose

複数のジョブで myDownloadJob を名前として使用する場合は、ジョブの GUID を使用して、完了のために一意に識別する必要があります。

ダウンロード ジョブを完了する

状態が TRANSFERRED に変更された後にジョブを完了するには、次の手順を実行します。

bitsadmin /complete myDownloadJob

ジョブ内のファイルが使用可能になる前に、/complete スイッチを実行する必要があります。 複数のジョブで myDownloadJob を名前として使用する場合は、ジョブの GUID を使用して、完了のために一意に識別する必要があります。

/list スイッチを使用して転送キュー内のジョブを監視する

ジョブの状態と、転送キュー内のすべてのジョブに転送されたファイルとバイト数を返します。

bitsadmin /list

サンプル出力

{6AF46E48-41D3-453F-B7AF-A694BBC823F7} job1 SUSPENDED 0 / 0 0 / 0
{482FCAF0-74BF-469B-8929-5CCD028C9499} job2 TRANSIENT_ERROR 0 / 1 0 / UNKNOWN

Listed 2 job(s).

/monitor スイッチを使用して転送キュー内のジョブを監視する

ジョブの状態と、転送キュー内のすべてのジョブに転送されたファイルとバイト数を返す場合は、5 秒ごとにデータを更新します。

bitsadmin /monitor

Note

更新を停止するには、Ctrl + C キーを押します。

サンプル出力

MONITORING BACKGROUND COPY MANAGER(5 second refresh)
{6AF46E48-41D3-453F-B7AF-A694BBC823F7} job1 SUSPENDED 0 / 0 0 / 0
{482FCAF0-74BF-469B-8929-5CCD028C9499} job2 TRANSIENT_ERROR 0 / 1 0 / UNKNOWN
{0B138008-304B-4264-B021-FD04455588FF} job3 TRANSFERRED 1 / 1 100379370 / 100379370

/info スイッチを使用して転送キュー内のジョブを監視する

ジョブの状態と転送されたファイルとバイト数を返す場合:

bitsadmin /info

サンプル出力

GUID: {482FCAF0-74BF-469B-8929-5CCD028C9499} DISPLAY: myDownloadJob
TYPE: DOWNLOAD STATE: TRANSIENT_ERROR OWNER: domain\user
PRIORITY: NORMAL FILES: 0 / 1 BYTES: 0 / UNKNOWN
CREATION TIME: 12/17/2002 1:21:17 PM MODIFICATION TIME: 12/17/2002 1:21:30 PM
COMPLETION TIME: UNKNOWN
NOTIFY INTERFACE: UNREGISTERED NOTIFICATION FLAGS: 3
RETRY DELAY: 600 NO PROGRESS TIMEOUT: 1209600 ERROR COUNT: 0
PROXY USAGE: PRECONFIG PROXY LIST: NULL PROXY BYPASS LIST: NULL
ERROR FILE:    https://downloadsrv/10mb.zip -> c:\10mb.zip
ERROR CODE:    0x80072ee7 - The server name or address could not be resolved
ERROR CONTEXT: 0x00000005 - The error occurred while the remote file was being
processed.
DESCRIPTION:
JOB FILES:
0 / UNKNOWN WORKING https://downloadsrv/10mb.zip -> c:\10mb.zip
NOTIFICATION COMMAND LINE: none

転送キューからジョブを削除する

転送キューからすべてのジョブを削除するには、/reset スイッチを使用します。

bitsadmin /reset

サンプル出力

{DC61A20C-44AB-4768-B175-8000D02545B9} canceled.
{BB6E91F3-6EDA-4BB4-9E01-5C5CBB5411F8} canceled.
2 out of 2 jobs canceled.