Dela via

bitsadmin-exempel

I följande exempel visas hur du använder verktyget bitsadmin för att utföra de vanligaste uppgifterna.

Överföra en fil

Om du vill skapa ett jobb lägger du till filer, aktiverar jobbet i överföringskö och slutför jobbet:

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

BITSAdmin fortsätter att visa förloppsinformation i MS-DOS-fönstret tills överföringen har slutförts eller ett fel inträffar.

Skapa ett nedladdningsjobb

Skapa ett nedladdningsjobb med namnet myDownloadJob:

bitsadmin /create myDownloadJob

BITSAdmin returnerar ett GUID som unikt identifierar jobbet. Använd GUID eller jobbnamnet i efterföljande anrop. Följande text är exempelutdata.

Exempelutdata

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

Lägga till filer i nedladdningsjobbet

Så här lägger du till en fil i jobbet:

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

Upprepa det här anropet för varje fil som du vill lägga till. Om flera jobb använder myDownloadJob som deras namn måste du använda jobbets GUID för att unikt identifiera det för slutförande.

Aktivera nedladdningsjobbet

När du har skapat ett nytt jobb pausar BITS automatiskt jobbet. Så här aktiverar du jobbet i överföringskö:

bitsadmin /resume myDownloadJob

Om flera jobb använder myDownloadJob som deras namn måste du använda jobbets GUID för att unikt identifiera det för slutförande.

Fastställa förloppet för nedladdningsjobbet

Växeln /info returnerar jobbets tillstånd och antalet filer och byte som överförs. När tillståndet visas som TRANSFERREDinnebär det att BITS har överfört alla filer i jobbet. Du kan också lägga till argumentet /verbose för att få fullständig information om jobbet och /list eller /monitor för att hämta alla jobb i överföringskö.

Så här returnerar du jobbets tillstånd:

bitsadmin /info myDownloadJob /verbose

Om flera jobb använder myDownloadJob som deras namn måste du använda jobbets GUID för att unikt identifiera det för slutförande.

Slutför nedladdningsjobbet

Så här slutför du jobbet efter att tillståndet har ändrats till TRANSFERRED:

bitsadmin /complete myDownloadJob

Du måste köra växeln /complete innan filerna i jobbet blir tillgängliga. Om flera jobb använder myDownloadJob som deras namn måste du använda jobbets GUID för att unikt identifiera det för slutförande.

Övervaka jobb i överföringskö med växeln /list

Så här returnerar du jobbets tillstånd och antalet filer och byte som överförts för alla jobb i överföringskö:

bitsadmin /list

Exempelutdata

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

Övervaka jobb i överföringskö med växeln /monitor

Om du vill returnera jobbets tillstånd och antalet filer och byte som överförts för alla jobb i överföringskö uppdaterar du data var femte sekund:

bitsadmin /monitor

Anmärkning

Tryck på CTRL+C för att stoppa uppdateringen.

Exempelutdata

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

Övervaka jobb i överföringskö med växeln /info

Så här returnerar du jobbets tillstånd och antalet filer och byte som överförs:

bitsadmin /info

Exempelutdata

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

Ta bort jobb från överföringskö

Om du vill ta bort alla jobb från överföringskö använder du växeln /reset:

bitsadmin /reset

Exempelutdata

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