共用方式為


bitsadmin examples

下列範例示範如何使用 bitsadmin 工具來執行最常見的工作。

傳輸檔案

若要建立作業,請新增檔案、在傳輸佇列中啟動作業,然後完成作業:

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

BITSAdmin 會繼續在 MS-DOS 視窗中顯示進度資訊,直到傳輸完成或發生錯誤為止。

建立下載作業

若要建立名為 myDownloadJob 的下載作業:

bitsadmin /create myDownloadJob

BITSAdmin 會傳回可唯一識別作業的 GUID。 在後續呼叫中使用 GUID 或作業名稱。 下列文字是範例輸出。

Sample output

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

Sample output

{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。

Sample output

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

Sample output

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

Sample output

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