Freigeben über

Bitsadmin-Beispiele

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

Übertragen einer Datei

Um einen Auftrag zu erstellen, fügen Sie Dateien hinzu, aktivieren Sie den Auftrag in der Übertragungswarteschlange, und führen Sie den Auftrag aus:

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 namens 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 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 eindeutig für den Abschluss 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 eindeutig für den Abschluss zu identifizieren.

Ermitteln des Fortschritts des Downloadauftrags

Die /info Switch gibt den Status des Auftrags und die Anzahl der übertragenen Dateien und Bytes zurück. Wenn der Zustand als TRANSFERREDangezeigt wird, bedeutet dies, dass BITS alle Dateien im Auftrag erfolgreich übertragen hat. Sie können auch das Argument /verbose hinzufügen, um vollständige Details des Auftrags abzurufen, und /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 eindeutig für den Abschluss zu identifizieren.

Abschließen des Downloadauftrags

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

bitsadmin /complete myDownloadJob

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

Überwachen von Aufträgen in der Übertragungswarteschlange mithilfe des Schalters "/list"

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 werden:

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 des Schalters "/monitor"

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

bitsadmin /monitor

Hinweis

Um die Aktualisierung zu beenden, drücken Sie STRG+C.

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 des Schalters "/info"

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 den Schalter "/reset":

bitsadmin /reset

Beispielausgabe

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