Sdílet prostřednictvím


bitsadmin examples

Následující příklady ukazují, jak pomocí nástroje bitsadmin provádět nejběžnější úlohy.

Přenos souboru

Pokud chcete vytvořit úlohu, přidat soubory, aktivovat úlohu ve frontě přenosu a dokončit úlohu:

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

Nástroj BITSAdmin bude dál zobrazovat informace o průběhu v okně MS-DOS, dokud se přenos neprovede nebo dojde k chybě.

Vytvoření úlohy stahování

Vytvoření úlohy stahování s názvem myDownloadJob:

bitsadmin /create myDownloadJob

Nástroj BITSAdmin vrátí identifikátor GUID, který jednoznačně identifikuje úlohu. V následných voláních použijte identifikátor GUID nebo název úlohy. Následující text je ukázkový výstup.

Sample output

created job {C775D194-090F-431F-B5FB-8334D00D1CB6}

Přidání souborů do úlohy stahování

Přidání souboru do úlohy:

bitsadmin /addfile myDownloadJob https://downloadsrv/10mb.zip c:\\10mb.zip

Opakujte toto volání pro každý soubor, který chcete přidat. Pokud více úloh používá jako název myDownloadJob , musíte použít identifikátor GUID úlohy k její jednoznačné identifikaci pro dokončení.

Aktivace úlohy stahování

Po vytvoření nové úlohy služba BITS automaticky pozastaví úlohu. Aktivace úlohy ve frontě přenosu:

bitsadmin /resume myDownloadJob

Pokud více úloh používá jako název myDownloadJob , musíte použít identifikátor GUID úlohy k její jednoznačné identifikaci pro dokončení.

Určení průběhu úlohy stahování

Přepínač /info vrací stav úlohy a počet přenesených souborů a bajtů. Když se stav zobrazí jako TRANSFERRED, znamená to, že služba BITS úspěšně přenesla všechny soubory v úloze. Můžete také přidat argument /verbose pro získání úplných podrobností o úloze a /list nebo /monitor pro získání všech úloh ve frontě přenosu.

Vrácení stavu úlohy:

bitsadmin /info myDownloadJob /verbose

Pokud více úloh používá jako název myDownloadJob , musíte použít identifikátor GUID úlohy k její jednoznačné identifikaci pro dokončení.

Dokončení úlohy stahování

Dokončení úlohy po změně stavu na TRANSFERRED:

bitsadmin /complete myDownloadJob

Před zpřístupněním souborů v úloze musíte spustit přepínač /complete. Pokud více úloh používá jako název myDownloadJob , musíte použít identifikátor GUID úlohy k její jednoznačné identifikaci pro dokončení.

Monitorování úloh ve frontě přenosu pomocí přepínače /list

Chcete-li vrátit stav úlohy a počet souborů a bajtů přenesených pro všechny úlohy ve frontě přenosu:

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).

Monitorování úloh ve frontě přenosu pomocí přepínače /monitor

Pokud chcete vrátit stav úlohy a počet souborů a bajtů přenesených pro všechny úlohy ve frontě přenosu, aktualizujte data každých 5 sekund:

bitsadmin /monitor

Note

Pokud chcete aktualizaci zastavit, stiskněte 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

Monitorování úloh ve frontě přenosu pomocí přepínače /info

Vrácení stavu úlohy a počtu přenesených souborů a bajtů:

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

Odstranění úloh z přenosové fronty

Pokud chcete odebrat všechny úlohy z přenosové fronty, použijte přepínač /reset:

bitsadmin /reset

Sample output

{DC61A20C-44AB-4768-B175-8000D02545B9} canceled.
{BB6E91F3-6EDA-4BB4-9E01-5C5CBB5411F8} canceled.
2 out of 2 jobs canceled.