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


bitsadmin examples

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

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

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

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

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

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

Чтобы создать задание скачивания с именем myDownloadJob, выполните указанные действия.

bitsadmin /create myDownloadJob

BITS Администратор возвращает 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.