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 à ajouter. Si plusieurs travaux utilisent myDownloadJob comme nom, vous devez utiliser le GUID du travail pour l’identifier de manière unique pour l’achèvement.
Activer le travail de téléchargement
Après avoir 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 l’achèvement.
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é sous la forme 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 l’achèvement.
Terminer le travail de téléchargement
Pour terminer le travail une fois que l’état est passé à TRANSFERRED:
bitsadmin /complete myDownloadJob
Vous devez exécuter le commutateur /complete avant que les fichiers du travail soient disponibles. Si plusieurs travaux utilisent myDownloadJob comme nom, vous devez utiliser le GUID du travail pour l’identifier de manière unique pour l’achèvement.
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
Notes
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.