Partager via

bitsadmin examples

Les exemples suivants montrent comment utiliser l’outil bitsadmin pour effectuer les tâches les plus courantes.

Transférer un fichier

Pour créer un travail, ajoutez des fichiers, activez le travail dans la file d’attente de transfert et terminez le travail :

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

BITSAdmin continue d’afficher les informations de progression dans la fenêtre MS-DOS jusqu’à ce que le transfert se termine ou qu’une erreur se produise.

Créer un travail de téléchargement

Pour créer une tâche de téléchargement nommée myDownloadJob :

bitsadmin /create myDownloadJob

BITSAdmin retourne un GUID qui identifie de manière unique le travail. Utilisez le GUID ou le nom du travail dans les appels suivants. Le texte suivant est un exemple de sortie.

Sample output

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

Ajouter des fichiers au travail de téléchargement

Pour ajouter un fichier au travail :

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

Répétez cet appel pour chaque fichier que vous souhaitez ajouter. Si plusieurs tâches utilisent le nom myDownloadJob , vous devez utiliser le GUID de la tâche pour l’identifier de manière unique afin de la terminer.

Activer le travail de téléchargement

Une fois que vous avez créé un travail, BITS suspend automatiquement le travail. Pour activer le travail dans la file d’attente de transfert :

bitsadmin /resume myDownloadJob

Si plusieurs tâches utilisent le nom myDownloadJob , vous devez utiliser le GUID de la tâche pour l’identifier de manière unique afin de la terminer.

Déterminer la progression du travail de téléchargement

Le commutateur /info renvoie l’état de la tâche et le nombre de fichiers et d’octets transférés. Lorsque l’état est affiché comme TRANSFERRED, cela signifie que BITS a correctement transféré tous les fichiers du travail. Vous pouvez également ajouter l’argument /verbose pour obtenir des détails complets sur le travail, et /list ou /monitor pour obtenir tous les travaux dans la file d’attente de transfert.

Pour retourner l’état du travail :

bitsadmin /info myDownloadJob /verbose

Si plusieurs tâches utilisent le nom myDownloadJob , vous devez utiliser le GUID de la tâche pour l’identifier de manière unique afin de la terminer.

Terminer le travail de téléchargement

Pour terminer le travail après que l’état passe à TRANSFERRED:

bitsadmin /complete myDownloadJob

Vous devez exécuter le commutateur /complete avant que les fichiers du travail ne soient disponibles. Si plusieurs tâches utilisent le nom myDownloadJob , vous devez utiliser le GUID de la tâche pour l’identifier de manière unique afin de la terminer.

Surveiller les travaux dans la file d’attente de transfert à l’aide du commutateur /list

Pour retourner l’état du travail et le nombre de fichiers et d’octets transférés pour tous les travaux de la file d’attente de transfert :

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

Surveiller les travaux dans la file d’attente de transfert à l’aide du commutateur /monitor

Pour retourner l’état du travail et le nombre de fichiers et d’octets transférés pour tous les travaux de la file d’attente de transfert, actualisez les données toutes les 5 secondes :

bitsadmin /monitor

Note

Pour arrêter l’actualisation, appuyez sur 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

Surveiller les travaux dans la file d’attente de transfert à l’aide du commutateur /info

Pour retourner l’état du travail et le nombre de fichiers et d’octets transférés :

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

Supprimer des travaux de la file d’attente de transfert

Pour supprimer tous les travaux de la file d’attente de transfert, utilisez le commutateur /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