Esempi di bitsadmin
I seguenti esempi illustrano come usare lo strumento bitsadmin per eseguire le attività più comuni.
Trasferire un file
Per creare un processo, aggiungere file, attivare il processo nella coda di trasferimento e completare il processo:
bitsadmin /transfer myDownloadJob /download /priority normal https://downloadsrv/10mb.zip c:\\10mb.zip
BITS Amministrazione continua a visualizzare le informazioni sullo stato di avanzamento nella finestra MS-DOS finché il trasferimento non viene completato o si verifica un errore.
Creare un processo di download
Per creare un processo di download denominato myDownloadJob:
bitsadmin /create myDownloadJob
BITSAdmin restituisce un GUID che identifica il processo in modo univoco. Usare il GUID o il nome del processo nelle chiamate successive. Il testo che segue è un output di esempio.
Output di esempio
created job {C775D194-090F-431F-B5FB-8334D00D1CB6}
Aggiungere file al processo di download
Per aggiungere un file al processo:
bitsadmin /addfile myDownloadJob https://downloadsrv/10mb.zip c:\\10mb.zip
Ripetere questa chiamata per ciascun file che si desidera aggiungere. Se più processi usano myDownloadJob come nome, è necessario usare il GUID del processo per identificarlo in modo univoco per il completamento.
Attivare il processo di download
Dopo aver creato un nuovo processo, BITS sospende automaticamente il processo. Per attivare il processo nella coda di trasferimento:
bitsadmin /resume myDownloadJob
Se più processi usano myDownloadJob come nome, è necessario usare il GUID del processo per identificarlo in modo univoco per il completamento.
Determinare lo stato di avanzamento del processo di download
L'opzione /info restituisce lo stato del processo e il numero di file e byte trasferiti. Quando lo stato viene visualizzato come TRANSFERRED, significa che BITS ha trasferito correttamente tutti i file nel processo. È anche possibile aggiungere l'argomento /verbose per ottenere i dettagli completi del processo e /list o /monitor per ottenere tutti i processi nella coda di trasferimento.
Per restituire lo stato del processo:
bitsadmin /info myDownloadJob /verbose
Se più processi usano myDownloadJob come nome, è necessario usare il GUID del processo per identificarlo in modo univoco per il completamento.
Completare il processo di download
Per completare il processo dopo che lo stato cambia in TRANSFERRED:
bitsadmin /complete myDownloadJob
È necessario eseguire l'opzione /complete prima che i file nel processo diventino disponibili. Se più processi usano myDownloadJob come nome, è necessario usare il GUID del processo per identificarlo in modo univoco per il completamento.
Monitorare i processi nella coda di trasferimento usando l'opzione /list
Per restituire lo stato del processo e il numero di file e byte trasferiti per tutti i processi nella coda di trasferimento:
bitsadmin /list
Output di esempio
{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).
Monitorare i processi nella coda di trasferimento usando l'opzione /monitor
Per restituire lo stato del processo e il numero di file e byte trasferiti per tutti i processi nella coda di trasferimento, aggiornando i dati ogni 5 secondi:
bitsadmin /monitor
Nota
Per interrompere l'aggiornamento, premere CTRL+C.
Output di esempio
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
Monitorare i processi nella coda di trasferimento usando l'opzione /info
Per restituire lo stato del processo e il numero di file e byte trasferiti:
bitsadmin /info
Output di esempio
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
Eliminare processi dalla coda di trasferimento
Per rimuovere tutti i processi dalla coda di trasferimento, usare l'opzione /reset:
bitsadmin /reset
Output di esempio
{DC61A20C-44AB-4768-B175-8000D02545B9} canceled.
{BB6E91F3-6EDA-4BB4-9E01-5C5CBB5411F8} canceled.
2 out of 2 jobs canceled.