Поделиться через

bitsadmin examples

В следующих примерах показано, как использовать средство bitsadmin для выполнения наиболее распространенных задач.

Передача файла

Чтобы создать задание, добавьте файлы, активируйте задание в очереди передачи и выполните задание:

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

BITSAdmin продолжает отображать сведения о ходе выполнения в окне MS-DOS до завершения передачи или ошибки.

Создание задания загрузки

To create a download job named 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

Повторите этот вызов для каждого файла, который требуется добавить. If multiple jobs use myDownloadJob as their name, you must use the job's GUID to uniquely identify it for completion.

Активация задания скачивания

После создания нового задания BITS автоматически приостанавливает задание. Чтобы активировать задание в очереди передачи, выполните следующие действия.

bitsadmin /resume myDownloadJob

If multiple jobs use myDownloadJob as their name, you must use the job's GUID to uniquely identify it for completion.

Определение хода выполнения задания загрузки

The /info switch returns the state of the job and the number of files and bytes transferred. Когда состояние отображается как TRANSFERRED, это означает, что BITS успешно передал все файлы в задании. You can also add the /verbose argument to get complete details of the job, and /list or /monitor to get all the jobs in the transfer queue.

Чтобы вернуть состояние задания, выполните следующие действия.

bitsadmin /info myDownloadJob /verbose

If multiple jobs use myDownloadJob as their name, you must use the job's GUID to uniquely identify it for completion.

Завершение задания загрузки

Чтобы завершить задание после изменения состояния в TRANSFERRED:

bitsadmin /complete myDownloadJob

Перед тем как файлы в задании станут доступными, необходимо запустить параметр /complete. If multiple jobs use myDownloadJob as their name, you must use the job's GUID to uniquely identify it for completion.

Мониторинг заданий в очереди передачи с помощью переключателя /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.