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).
/list 스위치를 사용하여 전송 큐의 작업 모니터링
전송 큐의 모든 작업에 대해 전송된 작업 상태와 파일 및 바이트 수를 반환하려면 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.