Freigeben über


bitsadmin examples

Die folgenden Beispiele zeigen, wie Sie das Tool bitsadmin verwenden, um die häufigsten Aufgaben auszuführen.

Übertragen einer Datei

Um einen Auftrag zu erstellen, fügen Sie Dateien hinzu, aktivieren Sie den Auftrag in der Übertragungswarteschlange, und um den Auftrag abzuschließen:

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

BITSAdmin zeigt weiterhin Statusinformationen im MS-DOS-Fenster an, bis die Übertragung abgeschlossen ist oder ein Fehler auftritt.

Erstellen eines Downloadauftrags

So erstellen Sie einen Downloadauftrag mit dem Namen myDownloadJob:

bitsadmin /create myDownloadJob

BITSAdmin gibt eine GUID zurück, die den Auftrag eindeutig identifiziert. Verwenden Sie die GUID oder den Auftragsnamen in nachfolgenden Aufrufen. Der folgende Text ist eine Beispielausgabe.

Beispielausgabe

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

Hinzufügen von Dateien zum Downloadauftrag

So fügen Sie dem Auftrag eine Datei hinzu:

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

Wiederholen Sie diesen Aufruf für jede Datei, die Sie hinzufügen möchten. Wenn mehrere Aufträge myDownloadJob als Namen verwenden, müssen Sie die GUID des Auftrags verwenden, um ihn für den Abschluss eindeutig zu identifizieren.

Aktivieren des Downloadauftrags

Nachdem Sie einen neuen Auftrag erstellt haben, hält BITS den Auftrag automatisch an. So aktivieren Sie den Auftrag in der Übertragungswarteschlange:

bitsadmin /resume myDownloadJob

Wenn mehrere Aufträge myDownloadJob als Namen verwenden, müssen Sie die GUID des Auftrags verwenden, um ihn für den Abschluss eindeutig zu identifizieren.

Ermitteln des Status des Downloadauftrags

Die Option /info gibt den Status des Auftrags und die Anzahl der übertragenen Dateien und Bytes zurück. Wenn der Status als TRANSFERRED angezeigt wird, bedeutet dies, dass BITS alle Dateien des Auftrags erfolgreich übertragen hat. Sie können auch das Argument /verbose hinzufügen, um vollständige Details des Auftrags abzurufen, sowie /list oder /monitor, um alle Aufträge in der Übertragungswarteschlange abzurufen.

So geben Sie den Status des Auftrags zurück:

bitsadmin /info myDownloadJob /verbose

Wenn mehrere Aufträge myDownloadJob als Namen verwenden, müssen Sie die GUID des Auftrags verwenden, um ihn für den Abschluss eindeutig zu identifizieren.

Abschließen des Downloadauftrags

So schließen Sie den Auftrag ab, nachdem sich der Status in TRANSFERRED geändert hat:

bitsadmin /complete myDownloadJob

Sie müssen die Option /complete ausführen, bevor die Dateien im Auftrag verfügbar werden. Wenn mehrere Aufträge myDownloadJob als Namen verwenden, müssen Sie die GUID des Auftrags verwenden, um ihn für den Abschluss eindeutig zu identifizieren.

Überwachen von Aufträgen in der Übertragungswarteschlange mithilfe der /list-Option

So geben Sie den Status des Auftrags und die Anzahl der Dateien und Bytes zurück, die für alle Aufträge in der Übertragungswarteschlange übertragen wurden:

bitsadmin /list

Beispielausgabe

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

Überwachen von Aufträgen in der Übertragungswarteschlange mithilfe der /monitor-Option

Um den Status des Auftrags und die Anzahl der für alle Aufträge in der Übertragungswarteschlange übertragenen Dateien und Bytes zurückzugeben, aktualisieren Sie die Daten alle 5 Sekunden:

bitsadmin /monitor

Hinweis

Drücken Sie STRG+C, um die Aktualisierung zu beenden.

Beispielausgabe

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

Überwachen von Aufträgen in der Übertragungswarteschlange mithilfe der /info-Option

So geben Sie den Status des Auftrags und die Anzahl der übertragenen Dateien und Bytes zurück:

bitsadmin /info

Beispielausgabe

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

Löschen von Aufträgen aus der Übertragungswarteschlange

Um alle Aufträge aus der Übertragungswarteschlange zu entfernen, verwenden Sie die /reset-Option:

bitsadmin /reset

Beispielausgabe

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