bitsadmin examples
Os exemplos a seguir mostram como usar a ferramenta bitsadmin para executar as tarefas mais comuns.
Transferir um arquivo
Para criar um trabalho, adicione arquivos, ative o trabalho na fila de transferência e conclua o trabalho:
bitsadmin /transfer myDownloadJob /download /priority normal https://downloadsrv/10mb.zip c:\\10mb.zip
O BITSAdmin continua a mostrar informações de progresso na janela MS-DOS até que a transferência seja concluída ou ocorra um erro.
Criar um trabalho de download
Para criar um trabalho de download denominado myDownloadJob:
bitsadmin /create myDownloadJob
O BITSAdmin retorna um GUID que identifica exclusivamente o trabalho. Use o GUID ou o nome do trabalho em chamadas subsequentes. O texto a seguir é uma saída de exemplo.
Saída de exemplo
created job {C775D194-090F-431F-B5FB-8334D00D1CB6}
Adicionar arquivos ao trabalho de download
Para adicionar um arquivo ao trabalho:
bitsadmin /addfile myDownloadJob https://downloadsrv/10mb.zip c:\\10mb.zip
Repita esta chamada para cada arquivo que queira adicionar. Se vários trabalhos usarem myDownloadJob como nome, use o GUID do trabalho para identificá-lo exclusivamente para a conclusão.
Ativar o trabalho de download
Depois de criar um novo trabalho, o BITS suspende automaticamente o trabalho. Para ativar o trabalho na fila de transferência:
bitsadmin /resume myDownloadJob
Se vários trabalhos usarem myDownloadJob como nome, use o GUID do trabalho para identificá-lo exclusivamente para a conclusão.
Determinar o progresso do trabalho de download
A opção /info retorna o estado do trabalho e o número de arquivos e bytes transferidos. Quando o estado é mostrado como TRANSFERRED, isso significa que o BITS transferiu com êxito todos os arquivos no trabalho. Você também pode adicionar o argumento /verbose para obter detalhes completos do trabalho e /list ou /monitor para obter todos os trabalhos na fila de transferência.
Para retornar o estado do trabalho:
bitsadmin /info myDownloadJob /verbose
Se vários trabalhos usarem myDownloadJob como nome, use o GUID do trabalho para identificá-lo exclusivamente para a conclusão.
Conclua o trabalho de download
Para concluir o trabalho depois que o estado for alterado para TRANSFERRED:
bitsadmin /complete myDownloadJob
Executar a opção /complete antes que os arquivos no trabalho fiquem disponíveis. Se vários trabalhos usarem myDownloadJob como nome, use o GUID do trabalho para identificá-lo exclusivamente para a conclusão.
Monitorar trabalhos na fila de transferência usando a opção /listar
Para retornar o estado do trabalho e o número de arquivos e bytes transferidos para todos os trabalhos na fila de transferência:
bitsadmin /list
Saída de exemplo
{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).
Monitorar trabalhos na fila de transferência usando a opção /monitorar
Para retornar o estado do trabalho e o número de arquivos e bytes transferidos para todos os trabalhos na fila de transferência, atualizando os dados a cada 5 segundos:
bitsadmin /monitor
Observação
Para interromper a atualização, pressione CTRL+C.
Saída de exemplo
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
Monitorar trabalhos na fila de transferência usando a opção /info
Para retornar o estado do trabalho e o número de arquivos e bytes transferidos:
bitsadmin /info
Saída de exemplo
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
Excluía trabalhos da fila de transferência
Para remover todos os trabalhos da fila de transferência, use a opção /reiniciar:
bitsadmin /reset
Saída de exemplo
{DC61A20C-44AB-4768-B175-8000D02545B9} canceled.
{BB6E91F3-6EDA-4BB4-9E01-5C5CBB5411F8} canceled.
2 out of 2 jobs canceled.