Condividi tramite

esempi di bitsadmin

Gli esempi seguenti 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

BITSAdmin continua a visualizzare le informazioni sullo stato di avanzamento nella finestra di MS-DOS fino al completamento del trasferimento o a un errore.

Creare un processo di download

Per creare un processo di download denominato myDownloadJob:

bitsadmin /create myDownloadJob

BITSAdmin restituisce un GUID che identifica in modo univoco il processo. Usare il GUID o il nome del processo nelle chiamate successive. Il testo seguente è l'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 ogni file da 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 arrestare 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.