Delen via

bitsadmin-voorbeelden

In de volgende voorbeelden ziet u hoe u het hulpprogramma bitsadmin gebruikt om de meest voorkomende taken uit te voeren.

Een bestand overdragen

Als u een taak wilt maken, voegt u bestanden toe, activeert u de taak in de overdrachtswachtrij en voltooit u de taak:

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

BITSAdmin blijft voortgangsinformatie weergeven in het MS-DOS venster totdat de overdracht is voltooid of er een fout optreedt.

Een downloadtaak maken

Een downloadtaak maken met de naam myDownloadJob:

bitsadmin /create myDownloadJob

BITSAdmin retourneert een GUID die de taak uniek identificeert. Gebruik de GUID of taaknaam in volgende aanroepen. De volgende tekst is voorbeelduitvoer.

Voorbeelduitvoer

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

Bestanden toevoegen aan de downloadtaak

Een bestand toevoegen aan de taak:

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

Herhaal deze aanroep voor elk bestand dat u wilt toevoegen. Als meerdere taken myDownloadJob als naam gebruiken, moet u de GUID van de taak gebruiken om deze uniek te identificeren voor voltooiing.

De downloadtaak activeren

Nadat u een nieuwe taak hebt gemaakt, onderbreekt BITS de taak automatisch. De taak in de overdrachtswachtrij activeren:

bitsadmin /resume myDownloadJob

Als meerdere taken myDownloadJob als naam gebruiken, moet u de GUID van de taak gebruiken om deze uniek te identificeren voor voltooiing.

De voortgang van de downloadtaak bepalen

De schakeloptie /info retourneert de status van de taak en het aantal bestanden en bytes dat is overgedragen. Wanneer de status wordt weergegeven als TRANSFERRED, betekent dit dat BITS alle bestanden in de taak heeft overgedragen. U kunt ook het argument /uitgebreide toevoegen om volledige details van de taak op te halen en /list of /monitor om alle taken in de overdrachtswachtrij op te halen.

De status van de taak retourneren:

bitsadmin /info myDownloadJob /verbose

Als meerdere taken myDownloadJob als naam gebruiken, moet u de GUID van de taak gebruiken om deze uniek te identificeren voor voltooiing.

De downloadtaak voltooien

De taak voltooien nadat de status is gewijzigd in TRANSFERRED:

bitsadmin /complete myDownloadJob

U moet de schakeloptie /complete uitvoeren voordat de bestanden in de taak beschikbaar komen. Als meerdere taken myDownloadJob als naam gebruiken, moet u de GUID van de taak gebruiken om deze uniek te identificeren voor voltooiing.

Taken in de overdrachtswachtrij bewaken met behulp van de schakeloptie /list

De status van de taak en het aantal bestanden en bytes dat is overgedragen voor alle taken in de overdrachtswachtrij retourneren:

bitsadmin /list

Voorbeelduitvoer

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

Taken in de overdrachtswachtrij bewaken met behulp van de schakeloptie /monitor

Als u de status van de taak en het aantal bestanden en bytes wilt retourneren dat is overgedragen voor alle taken in de overdrachtswachtrij, vernieuwt u de gegevens elke 5 seconden:

bitsadmin /monitor

Notitie

Druk op Ctrl+C om het vernieuwen te stoppen.

Voorbeelduitvoer

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

Taken in de overdrachtswachtrij bewaken met behulp van de schakeloptie /info

De status van de taak en het aantal bestanden en overgedragen bytes retourneren:

bitsadmin /info

Voorbeelduitvoer

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

Taken uit de overdrachtswachtrij verwijderen

Als u alle taken uit de overdrachtswachtrij wilt verwijderen, gebruikt u de schakeloptie /reset:

bitsadmin /reset

Voorbeelduitvoer

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