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.