Base de connaissance
Assigner des installations TeamViewer existantes via ligne de commande
Date de dernière modification: 25 sept. 2025
Vous pouvez affecter vos appareils via ligne de commande. Voici comment procéder en fonction du système d'exploitation de vos appareils.
Comment affecter un appareil via ligne de commande
- Ouvrez CMD.
- Sélectionnez votre dossier d'installation TeamViewer.
- Entrez la commande suivante (indiquée ci-dessous) dans la ligne de commande.
- Appuyez sur la touche Entrée de votre clavier.
- (Facultatif) Tapez
echo %errorlevel%
dans la ligne de commande pour vérifier si le processus a réussi :
- Si l'affectation a réussi, la valeur "0" doit être renvoyée à la ligne de commande.
- Toute autre valeur de retour indique un problème qui s'est produit pendant l'affectation. Pour plus d'informations, veuillez vous reporter à la section Codes d'erreur.
TeamViewer.exe assignment --id paste_your_assignment_id_here --offline
Exemple :
TeamViewer.exe assignment --id 0001CoBBChARKJtw_okR6o_fJ7AisynpEigIACAfAgAJAOjwtNCVK_JiM5lVdgdfguSk-gQ= --offline
Options facultatives de ligne de commande
Il existe plusieurs options supplémentaires que vous pouvez ajouter à votre ligne de commande :
Alias
--device-alias=[<name>]
Alias du nouvel appareil tel qu'il apparaîtra dans la liste des appareils ; cette propriété peut prendre les valeurs suivantes :
- --alias (sans valeur)
- l'alias de l'ordinateur sera l'ID TeamViewer
- --alias bonjour
- l'alias de l'ordinateur sera "bonjour"
- Paramètre de l'alias non spécifié
- l'alias de l'ordinateur sera %computername%
- --alias %systemvariable%
- l'alias sera la variable du système utilisé e.g. %username%
Exemple :
C:\Program Files\TeamViewer\TeamViewer.exe" assignment --id 123 --device-alias=%COMPUTERNAME-%USERNAME%
Astuce : Si vous voulez utiliser des espaces, vous devez tout mettre dans "..." comme dans l'exemple suivant :
C:\Program Files\TeamViewer\TeamViewer.exe" assignment --id 123 --device-alias=“%COMPUTERNAME Test %USERNAME%“
Retries
--retries
L'affectation est réitérée en cas d'erreurs temporaires. Notez qu'il y a un temps d'attente de 1 seconde entre chaque essai.
Timeout
--timeout
Définir le délai global en secondes utilisé pour toutes les tentatives d'affectation.
Exemple :
TeamViewer.exe assignment --id YOUR_ASSIGNMENT_ID --retries=3 --timeout=120
Pour les appareils hors ligne
--offline
Pour gérer les appareils hors ligne pendant leur affectation, l'affectation est stockée dans le registre sous forme de propriété cryptée et est exécutée automatiquement lorsque l'appareil se reconnecte. Cette propriété est supprimée une fois l'affectation de l'appareil réussie.
Pour une réaffectation avec le même ID d'affectation
--reassign
Ce paramètre vous permet de réassigner un appareil à l'aide du même ID d'affectation. Par défaut, les appareils rejettent les tentatives de réaffectation si l'ID d'affectation n'a pas changé. L'utilisation de --reassign applique l'ID d'affectation existant sur l'appareil, ce qui peut être utile dans les cas où l'affectation doit être réappliquée sans générer un nouvel ID d'affectation.
Codes erreur
| Code erreur | Description | Problème / Solution |
|---|---|---|
1 | Arguments de ligne de commande invalides | Il semble que vous ayez mal orthographié ou utilisé une mauvaise commande. Vérifiez votre commande et veuillez réessayer. |
2 | Erreur de vérification de la signature | - |
3 | Produit non installé | TeamViewer n'est pas installé. Installez TeamViewer avant d'effectuer une affectation. |
4 | Service config - échec d'accès | // ComAPI
La configuration de l'affectation n'a pas pu être vérifiée par rapport au Cloud TeamViewer. Veuillez réessayer plus tard. |
400 (40 under Linux/FreeBSD) | MDv2Assignment - argument invalide | Il semble y avoir une erreur dans la syntaxe de la ligne de commande ou un ID d'affectation non valide est utilisé. Veuillez vérifier la syntaxe générale de votre ligne de commande et vérifier que l'ID d'affectation copié soit une configuration valide à partir de la Management Console. |
401 (41 under Linux/FreeBSD) | MDv2Assignment - le service n'est pas en cours d'exécution | L'affectation ne peut pas être effectuée car TeamViewer ne fonctionne pas correctement. Veuillez vérifier que le service TeamViewer fonctionne. |
402 (42 under Linux/FreeBSD) | MDv2Assignment - version incompatible du service | Le service TeamViewer est incompatible avec la version exécutée du client TeamViewer. Il semble que l'installation n'ait pas été effectuée correctement. Veuillez vérifier l'installation et, si nécessaire, réinstaller TeamViewer. |
403 (43 under Linux/FreeBSD) | MDv2Assignment - pas en ligne | Le client TeamViewer n'a pas pu se connecter au Cloud TeamViewer afin d'assigner votre appareil. Veuillez vérifier si le client est en ligne et si votre connexion Internet fonctionne correctement, puis réessayez l'affectation. Envisagez d'utiliser l'option de réessais sur l'interface de ligne de commande si cela se produit fréquemment. |
404 (44 under Linux/FreeBSD) | MDv2Assignment - déjà en cours d'exécution | Un autre processus d'affectation est déjà en cours. Veuillez vérifier l'état de cette affectation. Vous pouvez le faire par exemple en vérifiant si l'appareil est déjà enregistré en tant qu'appareil géré dans la Management Console. |
405 (45 under Linux/FreeBSD) | MDv2Assignment - délai d'expiration | Votre tentative d'affectation a été interrompue. Veuillez réessayer. Envisagez d'augmenter le délai d'attente sur l'interface de ligne de commande si cela se produit fréquemment et/ou si le réseau est instable (par exemple, les réseaux mobiles). |
406 (46 under Linux/FreeBSD) | MDv2Assignment - échec | Votre affectation a échoué pour des raisons inconnues. Veuillez sauvegarder vos journaux et contacter le support.support |
407 (47 under Linux/FreeBSD) | MDv2Assignment - accès refusé | Vous n'avez pas les droits nécessaires pour exécuter une affectation. Assurez-vous que votre utilisateur dispose des droits d'administrateur local. |
408 (48 under Linux/FreeBSD) | MDv2Assignment - refusé par stratégie | La stratégie TeamViewer active sur cet appareil empêche la suppression de l'état d'affectation existant. Veuillez désactiver la stratégie dans la Management Console.
Note : La réaffectation supprime implicitement l'état existant et est donc également refusée. |
409 | MDv2Assignment - appareil déjà géré | L'appareil est déjà affecté à votre entreprise avec le même ID d'affectation. |
Prérequis :
- TeamViewer doit déjà être installé.
- Pour TeamViewer full client, l'option Démarrer avec macOS doit être activée.
Pour assigner un appareil macOS via ligne de commande, veuillez suivre les instructions ci-dessous :
- Ouvrez le Terminal.
- Entrez la commande suivante (indiquée ci-dessous) dans la ligne de commande.
- Appuyez sur la touche Entrée de votre clavier.
sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -assignment_id <ID> --offline
Exemple :
sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -assignment_id 0001CoBBChARKJtw_okR6o_fJ7AisynpEigIACAfAgAJAOjwtNCVK_JiM5lVdgdfguSk-gQ= --offline
sudo /Applications/TeamViewer.app/Contents/Helpers/TeamViewer_Assignment -assignment_id paste_your_assignment_id_here --offline
Exemple :
sudo /Applications/TeamViewer.app/Contents/Helpers/TeamViewer_Assignment -assignment_id 0001CoBBChARKJtw_okR6o_fJ7AisynpEigIACAfAgAJAOjwtNCVK_JiM5lVdgdfguSk-gQ= --offline
Options facultatives de la ligne de commande
Il existe plusieurs options supplémentaires que vous pouvez ajouter à votre ligne de commande :
Alias
--device-alias=[<name>]
Alias du nouvel appareil tel qu'il apparaîtra dans la liste des appareils ; cette propriété peut prendre les valeurs suivantes :
- --alias (sans valeur)
- l'alias de l'ordinateur sera l'ID TeamViewer
- --alias bonjour
- l'alias de l'ordinateur sera "bonjour"
Pour les appareils hors ligne
--offline
Pour gérer les appareils hors ligne pendant leur affectation, l'affectation est stockée dans le registre sous forme de propriété cryptée et est exécutée automatiquement lorsque l'appareil se reconnecte. Cette propriété est supprimée une fois l'affectation de l'appareil réussie.
Pour une réaffectation avec le même ID d'affectation
--reassign
Ce paramètre vous permet de réassigner un appareil à l'aide du même ID d'affectation. Par défaut, les appareils rejettent les tentatives de réaffectation si l'ID d'affectation n'a pas changé. L'utilisation de --reassign applique l'ID d'affectation existant sur l'appareil, ce qui peut être utile dans les cas où l'affectation doit être réappliquée sans générer un nouvel ID d'affectation.
sudo teamviewer assignment --id paste_your_assignment_id_here --offline
Exemple :
sudo teamviewer assignment --id 0001CoABChARKJtw_okR6o_fJ7AisynpEigIACAfAgAJAO4PLaOBrqNDgr6jwtNCVK_JiM5lVdgdfgYo3uQ3pGkAbX8bo_VqPw1Rt61-RLe9AKSwZ14uwOXtUN7FYflrHbWAqRKBF0h8V18ldMcVT1rLF --offline
Options facultatives de la ligne de commande
Il existe plusieurs options supplémentaires que vous pouvez ajouter à votre ligne de commande :
Alias
--device-alias=[<name>]
Alias du nouvel appareil tel qu'il apparaîtra dans la liste des appareils ; cette propriété peut prendre les valeurs suivantes :
- --alias (sans valeur)
- l'alias de l'ordinateur sera l'ID TeamViewer
- --alias bonjour
- l'alias de l'ordinateur sera "bonjour"
Pour les appareils hors ligne
--offline
Pour gérer les appareils hors ligne pendant leur affectation, l'affectation est stockée dans le registre sous forme de propriété cryptée et est exécutée automatiquement lorsque l'appareil se reconnecte. Cette propriété est supprimée une fois l'affectation de l'appareil réussie.
Pour une réaffectation avec le même ID d'affectation
--reassign
Ce paramètre vous permet de réassigner un appareil à l'aide du même ID d'affectation. Par défaut, les appareils rejettent les tentatives de réaffectation si l'ID d'affectation n'a pas changé. L'utilisation de --reassign applique l'ID d'affectation existant sur l'appareil, ce qui peut être utile dans les cas où l'affectation doit être réappliquée sans générer un nouvel ID d'affectation.
Codes erreur
| Code erreur | Description | Problème / Solution |
|---|---|---|
406 (46 under Linux/FreeBSD) | MDv2Assignment - échec | Votre affectation a échoué pour des raisons inconnues. Veuillez sauvegarder vos journaux et contacter le support.support |
407 (47 under Linux/FreeBSD) | MDv2Assignment - accès refusé | Vous n'avez pas les droits nécessaires pour exécuter une affectation. Assurez-vous que votre utilisateur dispose des droits d'administrateur local. |
408 (48 under Linux/FreeBSD) | MDv2Assignment - refusé par stratégie | La stratégie TeamViewer active sur cet appareil empêche la suppression de l'état d'affectation existant. Veuillez désactiver la stratégie dans la Management Console.
Note : La réaffectation supprime implicitement l'état existant et est donc également refusée. |
409 | MDv2Assignment - appareil déjà géré | L'appareil est déjà affecté à votre entreprise avec le même ID d'affectation. |
400 (40 under Linux/FreeBSD) | MDv2Assignment - argument invalide | Il semble y avoir une erreur dans la syntaxe de la ligne de commande ou un ID d'affectation non valide est utilisé. Veuillez vérifier la syntaxe générale de votre ligne de commande et vérifier que l'ID d'affectation copié soit une configuration valide à partir de la Management Console. |
401 (41 under Linux/FreeBSD) | MDv2Assignment - le service n'est pas en cours d'exécution | L'affectation ne peut pas être effectuée car TeamViewer ne fonctionne pas correctement. Veuillez vérifier que le service TeamViewer fonctionne. |
402 (42 under Linux/FreeBSD) | MDv2Assignment - version incompatible du service | Le service TeamViewer est incompatible avec la version exécutée du client TeamViewer. Il semble que l'installation n'ait pas été effectuée correctement. Veuillez vérifier l'installation et, si nécessaire, réinstaller TeamViewer. |
403 (43 under Linux/FreeBSD) | MDv2Assignment - pas en ligne | Le client TeamViewer n'a pas pu se connecter au Cloud TeamViewer afin d'assigner votre appareil. Veuillez vérifier si le client est en ligne et si votre connexion Internet fonctionne correctement, puis réessayez l'affectation. Envisagez d'utiliser l'option de réessais sur l'interface de ligne de commande si cela se produit fréquemment. |
404 (44 under Linux/FreeBSD) | MDv2Assignment - déjà en cours d'exécution | Un autre processus d'affectation est déjà en cours. Veuillez vérifier l'état de cette affectation. Vous pouvez le faire par exemple en vérifiant si l'appareil est déjà enregistré en tant qu'appareil géré dans la Management Console. |
405 (45 under Linux/FreeBSD) | MDv2Assignment - délai d'expiration | Votre tentative d'affectation a été interrompue. Veuillez réessayer. Envisagez d'augmenter le délai d'attente sur l'interface de ligne de commande si cela se produit fréquemment et/ou si le réseau est instable (par exemple, les réseaux mobiles). |
Comment mettre à jour / réécrire une affectation
Si un appareil est déjà affecté et que vous exécutez à nouveau l'affectation via la ligne de commande, l'affectation de l'appareil sera écrasée par la nouvelle. L'écrasement implique que l'ancienne affectation sera supprimée, et que les responsables ou les stratégies déjà affectées seront perdues.
Note : La stratégie TeamViewer "Empêcher la suppression de l'affectation" empêche également une nouvelle affectation sur un appareil déjà affecté.