Udostępnij przez

bitsadmin examples

W poniższych przykładach pokazano, jak używać narzędzia bitsadmin do wykonywania najbardziej typowych zadań.

Transfer pliku

Aby utworzyć zadanie, dodaj pliki, aktywuj zadanie w kolejce transferu i wykonaj zadanie:

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

BitSAdmin nadal wyświetla informacje o postępie w oknie MS-DOS do momentu zakończenia transferu lub wystąpienia błędu.

Tworzenie zadania pobierania

Aby utworzyć zadanie pobierania o nazwie myDownloadJob:

bitsadmin /create myDownloadJob

BitSAdmin zwraca identyfikator GUID, który jednoznacznie identyfikuje zadanie. Użyj identyfikatora GUID lub nazwy zadania w kolejnych wywołaniach. Poniższy tekst to przykładowe dane wyjściowe.

Sample output

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

Dodawanie plików do zadania pobierania

Aby dodać plik do zadania:

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

Powtórz to wywołanie dla każdego pliku, który chcesz dodać. Jeśli wiele zadań używa myDownloadJob jako nazwy, należy użyć identyfikatora GUID zadania, aby jednoznacznie zidentyfikować je do ukończenia.

Aktywowanie zadania pobierania

Po utworzeniu nowego zadania usługa BITS automatycznie zawiesza zadanie. Aby aktywować zadanie w kolejce transferu:

bitsadmin /resume myDownloadJob

Jeśli wiele zadań używa myDownloadJob jako nazwy, należy użyć identyfikatora GUID zadania, aby jednoznacznie zidentyfikować je do ukończenia.

Określanie postępu zadania pobierania

Przełącznik /info zwraca stan zadania oraz liczbę przesłanych plików i bajtów. Gdy stan jest wyświetlany jako TRANSFERRED, oznacza to, że usługa BITS pomyślnie przetransferowała wszystkie pliki w zadaniu. Możesz również dodać argument /verbose , aby uzyskać pełne szczegóły zadania, oraz /list lub /monitor , aby pobrać wszystkie zadania w kolejce transferu.

Aby zwrócić stan zadania:

bitsadmin /info myDownloadJob /verbose

Jeśli wiele zadań używa myDownloadJob jako nazwy, należy użyć identyfikatora GUID zadania, aby jednoznacznie zidentyfikować je do ukończenia.

Ukończenie zadania pobierania

Aby ukończyć zadanie po zmianie stanu na TRANSFERRED:

bitsadmin /complete myDownloadJob

Przed udostępnieniem plików w zadaniu należy uruchomić przełącznik /complete. Jeśli wiele zadań używa myDownloadJob jako nazwy, należy użyć identyfikatora GUID zadania, aby jednoznacznie zidentyfikować je do ukończenia.

Monitorowanie zadań w kolejce transferu przy użyciu przełącznika /list

Aby zwrócić stan zadania oraz liczbę plików i bajtów przesłanych dla wszystkich zadań w kolejce transferu:

bitsadmin /list

Sample output

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

Monitorowanie zadań w kolejce transferu przy użyciu przełącznika /monitor

Aby zwrócić stan zadania oraz liczbę plików i bajtów przesyłanych dla wszystkich zadań w kolejce transferu, odświeżając dane co 5 sekund:

bitsadmin /monitor

Note

Aby zatrzymać odświeżanie, naciśnij CTRL+C.

Sample output

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

Monitorowanie zadań w kolejce transferu przy użyciu przełącznika /info

Aby zwrócić stan zadania oraz liczbę plików i bajtów przeniesionych:

bitsadmin /info

Sample output

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

Usuwanie zadań z kolejki transferu

Aby usunąć wszystkie zadania z kolejki transferu, użyj przełącznika /reset:

bitsadmin /reset

Sample output

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