Partager via

exemples bitsadmin

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 un travail de téléchargement nommé 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.

Exemple de sortie

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 travaux utilisent myDownloadJob comme nom, vous devez utiliser le GUID du travail pour l’identifier de manière unique pour 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 travaux utilisent myDownloadJob comme nom, vous devez utiliser le GUID du travail pour l’identifier de manière unique pour la terminer.

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

Le commutateur /info retourne l’état du travail 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 du 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 travaux utilisent myDownloadJob comme nom, vous devez utiliser le GUID du travail pour l’identifier de manière unique pour 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 travaux utilisent myDownloadJob comme nom, vous devez utiliser le GUID du travail pour l’identifier de manière unique pour 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

Exemple de sortie

{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

Remarque

Pour arrêter l’actualisation, appuyez sur Ctrl+C.

Exemple de sortie

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

Exemple de sortie

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

Exemple de sortie

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