Udostępnij za pośrednictwem

przykłady bitsadmin

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.

Przykładowe dane wyjściowe

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ć go 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ć go do ukończenia.

Określanie postępu zadania pobierania

Przełącznik /info zwraca stan zadania oraz liczbę plików i bajtów przeniesionych. 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, a /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ć go 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ć go 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

Przykładowe dane wyjściowe

{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

Uwaga

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

Przykładowe dane wyjściowe

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

Przykładowe dane wyjściowe

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

Przykładowe dane wyjściowe

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