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 或作業名稱。 以下文字是範例輸出。
範例輸出
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
注意
若要停止刷新，請按 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.