Passer au contenu

Lignes de commande

Nous sommes heureux de vous fournir un ensemble complet d'outils en ligne de commande conçus pour améliorer la flexibilité et l'efficacité de notre logiciel. Ces outils permettent aux utilisateurs de script et d'automatiser diverses fonctionnalités, adaptant le logiciel pour répondre à leurs besoins et flux de travail spécifiques.

Explorez les possibilités et optimisez votre expérience avec nos options de ligne de commande.

Vous devez uniquement exécuter les lignes de commande suivantes en tant qu'administrateur élevé. En rappel, AdminTool.exe et TwoFactor.Admin.exe (module complémentaire 2FA) doivent être situés ici : C:\Program Files (x86)\TSplus\UserDesktop\files

Table des matières


Sauvegarder les données et les paramètres : /backup

Syntax :

AdminTool.exe /backup [cheminOptionnel] [paramètres]

Description :

Commande /backup est utilisé pour sauvegarder les données et les paramètres de TSplus.

Par défaut, la sauvegarde sera créée dans le répertoire des archives (C:\Backupparam)

Paramètres :

  • optionalPath pour sauvegarder dans un autre répertoire que celui par défaut. Les chemins relatifs et absolus sont autorisés.
  • /silent si ce paramètre est mentionné, la sauvegarde est effectuée silencieusement

Exemples :

AdminTool.exe /backup AdminTool.exe /backup “c:/TSplus/CustomBackupFolder” /silent

Pour plus d'informations, veuillez vous rendre sur TSplus - Paramètres de sauvegarde


Restaurer les données et les paramètres : /restore

Syntax :

AdminTool.exe /restore [cheminDeSauvegarde] [paramètres]

Description :

Commande /restore est utilisé pour restaurer les données et les paramètres de TSplus.

Le répertoire de sauvegarde spécifié doit contenir un dossier de données et un dossier de paramètres, comme créé par la commande /backup.

Paramètres :

  • backupPath le chemin où se trouve le dossier de sauvegarde à restaurer.
  • /silent si ce paramètre est mentionné, la restauration se fait silencieusement

Exemples :

AdminTool.exe /restore “C:/Backupparam” /silent AdminTool.exe /restore “C:/TSplus/CustomBackupFolder” /silent

Pour plus d'informations, veuillez vous rendre sur TSplus - Paramètres de sauvegarde


Serveur Web : /webstop , /webstart et /webrestart

Syntax :

AdminTool.exe /webstop

AdminTool.exe /webstart

AdminTool.exe /webrestart

Description :

Commande /webstop est utilisé pour arrêter le serveur Web.

Commande /webstart est utilisé pour démarrer le serveur Web.

Commande /webrestart est utilisé pour redémarrer le serveur Web.

Paramètres :

Aucun


Mise à jour : /update

Syntax :

AdminTool.exe /update [options]

Description :

Commande update est utilisé pour mettre à jour TSplus Remote Access et potentiellement Advanced Security.

Paramètres :

  • [options] :
    • /addons si cette option est utilisée, Advanced Security est également mis à jour, si une nouvelle version est disponible.

Exemple :

AdminTool.exe /update /addons


Appliquer les mises à jour de compatibilité Windows : /updatekernel

Syntax :

svcac.exe /updatekernel [/silent]

svcac.exe doit être situé ici : C:\Program Files (x86)\TSplus

Description :

Commande /updatekernel est utilisé pour appliquer des mises à jour de compatibilité Windows.

Ces mises à jour automatiques garantissent que TSplus Remote Access reste compatible avec les nouvelles mises à jour de Windows et évitent la nécessité de télécharger et de réinstaller une version plus récente de TSplus Remote Access.

Les mises à jour de compatibilité Windows peuvent se produire quotidiennement. TSplus Remote Access permet une mise à jour forcée. Cela est utile lorsque la compatibilité semble rompue et que vous devez récupérer le dernier correctif de TSplus Remote Access en dehors du calendrier de mise à jour régulier.

Veuillez noter qu'une licence valide est requise pour récupérer les mises à jour de compatibilité. Si votre licence d'essai a expiré ou si votre licence est invalide, un message d'erreur s'affichera. Veuillez contacter notre équipe de support avec une capture d'écran de ce message d'erreur si le problème est inattendu.

Paramètres :

  • [/silent] Mettez à jour silencieusement en fournissant ce paramètre. Aucune boîte de message ne sera affichée.

Installer l'imprimante universelle : /InstallUniversalPrinter

Syntax :

installateuruniversalprinter.exe /InstallerImprimanteUniverselle

universalprintermanagement.exe est situé ici : C:\Program Files (x86)\TSplus\UserDesktop\files

Description :

Commande /InstallUniversalPrinter est utilisé pour installer Universal Printer.

Ceci est une installation propre car elle supprime l'imprimante universelle existante si elle a été installée précédemment.

Paramètres :

Aucun

Vous pouvez également effectuer cette action manuellement, veuillez consulter Imprimante universelle


Supprimer UniversalPrinter : /RemoveUniversalPrinter

Syntax :

universalprintermanagement.exe /RemoveUniversalPrinter

universalprintermanagement.exe est situé ici : C:\Program Files (x86)\TSplus\UserDesktop\files

Description :

Commande /RemoveUniversalPrinter est utilisé pour désinstaller Universal Printer.

Paramètres :

Aucun

Vous pouvez également effectuer cette action manuellement, veuillez consulter Imprimante universelle


Configurer le serveur proxy : /proxy /set

Syntax :

AdminTool.exe /proxy /set [paramètres]

Description :

Commande /proxy /set est utilisé pour configurer un serveur proxy pour l'accès à Internet.

Paramètres :

  • /host le serveur de destination peut être une valeur prédéfinie (“ie” ou “none”) ou une valeur définie par l'utilisateur (par exemple : 127.0.0.1 ou proxy.company.org). Ce paramètre est obligatoire
  • /port le numéro de port utilisé pour se connecter au serveur proxy. Requis si la valeur du nom d'hôte est une valeur personnalisée définie par l'utilisateur.
  • /username le nom d'utilisateur pour se connecter au serveur proxy. Ce paramètre est facultatif
  • /password le mot de passe de l'utilisateur doit être fourni si un nom d'utilisateur a été défini. Cependant, sa valeur peut être vide

Exemples :

AdminTool.exe /proxy /set /host proxy.company.org /port 80 /username dummy /password pass@word1

AdminTool.exe /proxy /set /host ie

Pour plus d'informations, veuillez vous rendre sur Comment configurer un serveur proxy pour l'accès à Internet ?


Ouvrir le formulaire d'identifiants Web : /webcredentials

Syntax :

AdminTool.exe /webcredentials

Description :

Commande /webcredentials lance dans une seule fenêtre l'interface Web Credentials (comme vous le feriez dans AdminTool > Web > Web Credentials).

Paramètres :

Aucun


Créer des identifiants Web : /webcredentials-add

Syntax :

AdminTool.exe /webcredentials-add [webLogin] [webPassword] [windowsLogin] [windowsPassword] [maximumConcurrentSessions]

Description :

Commande /webcredentials-add est utilisé pour créer des identifiants Web (comme vous le feriez dans AdminTool > Web > Identifiants Web).

Paramètres :

  • webLogin le login web que vous souhaitez créer.
  • webPassword le mot de passe web associé. Il peut s'agir d'un identifiant vide. Pour cela, utilisez des guillemets doubles "" pour indiquer un mot de passe vide.
  • windowsLogin le login Windows de l'utilisateur correspondant.
  • windowsPassword le mot de passe Windows.
  • maximumConcurrentSessions (optionnel) : le nombre maximum de sessions simultanées pour cet utilisateur.

Exemple :

AdminTool.exe /webcredentials-add johndoe passwordABCD johnWinuser johnWinpassword 4

Pour plus d'informations, veuillez vous rendre sur Identifiants Web


Supprimer les identifiants Web : /webcredentials-remove

Syntax :

AdminTool.exe /webcredentials-remove [webLogin]

Description :

Commande /webcredentials-remove est utilisé pour supprimer un identifiant Web existant (comme vous le feriez dans AdminTool > Web > Identifiants Web).

Paramètres :

  • webLogin le login web que vous souhaitez supprimer.

Exemple :

AdminTool.exe /webcredentials-remove johndoe

Pour plus d'informations, veuillez vous rendre sur Identifiants Web


Gestionnaire de session ouverte : /sessionmanager

Syntax :

AdminTool.exe /gestiondesessions

Description :

Commande /sessionmanager lance dans une seule fenêtre de taille importante le gestionnaire de session (comme vous le feriez dans AdminTool > Accueil > Gestionnaire de session).

Paramètres :

Aucun


Moniteur des sessions ouvertes : /farm-sessions-monitor

Syntax :

AdminTool.exe /surveiller-sessions-ferme

Description :

Commande /farm-sessions-monitor lance dans une seule fenêtre de taille importante le moniteur de session du gestionnaire de ferme (comme vous le feriez dans AdminTool > Ferme > Surveiller les sessions).

Paramètres :

Aucun


Ouvrir le gestionnaire d'équilibrage de charge : /farm-loadbalancing

Syntax :

AdminTool.exe /répartition-de-charge-farm

Description :

Commande /farm-loadbalancing lance dans une seule fenêtre de taille importante le gestionnaire d'équilibrage de charge du gestionnaire de ferme (comme vous le feriez dans AdminTool > Ferme > Équilibrage de charge).

Paramètres :

Aucun


Exécuter l'audit du système : /systemaudit

Syntax :

AdminTool.exe /systemaudit

Description :

Commande /systemaudit exécute un audit système (comme vous le feriez manuellement dans AdminTool > Accueil > Audit système > Exécuter l'audit système).

Paramètres :

Aucun


Activation de la licence : /activate

Syntax :

AdminTool.exe /activer [licensePath]

Description :

Commande activate est utilisé pour activer la licence Remote Access, en utilisant un fichier de licence.

Paramètres :

  • [licensePath] le chemin du fichier de licence

Exemple :

AdminTool.exe /activate “C:\Program Files (x86)\TSplus\license.lic”


Réinitialisation de la licence suite au clonage d'une machine virtuelle : /reset

Syntax :

AdminTool.exe /license /reset

Description :

Lors de la clonage d'un serveur, l'onglet 'Licence' dans AdminTool peut ne pas afficher un ID d'ordinateur ou peut afficher le message d'erreur : "Identifiant matériel invalide." La commande /reset vise à initialiser la licence sur le serveur clone afin que de nouvelles licences puissent être attribuées pour les produits TSplus installés.

Remarques importantes :

  1. Une nouvelle licence TSplus doit être activée à l'aide d'une nouvelle clé d'activation.
  2. Ne pas utiliser la commande /license /reset sur une machine non clonée, car cela empêche définitivement l'attribution de la licence. Toujours confirmer l'état de la machine avant de procéder.

Étapes pour réinitialiser la licence sur un serveur cloné :

  1. Ouvrez une session Administrateur sur le serveur cloné.

  2. Changer le numéro de série du volume HDD.

  • Exécutez le vol commande pour afficher le numéro de série du volume actuel (VSN). Le résultat devrait ressembler à : 74F8-9C08 .

  • Téléchargez et installez l'utilitaire VolumeID, disponible ici .

  • Exécutez la commande : volumeid C: 84F8-9C08 en tant qu'administrateur pour changer le VSN du lecteur. Dans cet exemple, nous avons changé le VSN du disque C: et j'ai changé seulement un caractère (le premier) de l'ancien VSN pour spécifier le nouveau.

  • Note : cette étape est cruciale car certaines versions de Windows Server ne génèrent pas un nouveau numéro de série de volume lors du clonage, même en utilisant SysPrep.

  1. Renommez le serveur cloné et redémarrez-le.

  2. Réinitialiser la licence dans AdminTool :

  • Ouvrez une invite de commandes avec des privilèges d'administrateur.

  • Naviguez vers le répertoire contenant l'exécutable AdminTool en utilisant cette commande : cd "C:\Program Files (x86)\TSplus\UserDesktop\files"

  • Exécutez la commande suivante : AdminTool.exe /license /reset

  1. Vérifiez la réinitialisation.
  • Après avoir exécuté la commande, l'onglet 'Licence' devrait afficher l'erreur suivante : "Failed to read license file (unexpected file format)."
  1. Activez la nouvelle licence.
  • Dans l'onglet « Licence », cliquez sur « Activer votre licence » et saisissez la nouvelle clé d'activation pour activer les licences et les supports requis.

Exemple :

AdminTool.exe /license /reset TSplus-Security.exe /license /reset ServerMonitoring.exe /license /reset


Activation de la licence en volume : /vl /activate

Syntax :

AdminTool.exe /vl /activer [licensekey] [parameters]

Description :

Commande vl /activate est utilisé pour activer une licence en volume.

Paramètres :

  • licensekey clé de licence pour activer, dans ce format : AAAA-BBBB-CCCC-DDDD
  • /users : tout nombre de 1 à 50, ou "illimité"
  • /edition “Bureau”, “Web Mobile” ou “Entreprise”
  • /supportyears Tout nombre de 0 à 3.
  • /comments Spécifie les commentaires à joindre à la licence sur le portail de licence

Exemple :

AdminTool.exe /vl /activate VOLU-MELI-CENS-EKEY /users illimité /edition Entreprise /supportyears 3 /comments “Ceci est un commentaire”

Pour plus d'informations, veuillez vous rendre sur Documentation de licence en volume


Activer et désactiver la licence en volume : /vl /enable et /vl /disable

Syntax :

AdminTool.exe /vl /enable [licensekey]

AdminTool.exe /vl /disable [licensekey]

Description :

Commande vl /enable est utilisé pour activer une licence en volume.

Commande vl /disable est utilisé pour désactiver une licence en volume.

Paramètres :

  • licensekey clé de licence pour activer/désactiver, dans ce format : AAAA-BBBB-CCCC-DDDD

Exemples :

AdminTool.exe /vl /enable VOLU-MELI-CENS-EKEY

AdminTool.exe /vl /disable VOLU-MELI-CENS-EKEY

Pour plus d'informations, veuillez vous rendre sur Comment activer/désactiver une licence depuis le serveur ?


Mise à jour de la licence en volume : /vl /update

Syntax :

AdminTool.exe /vl /update [licensekey] [parameters]

Description :

Commande vl /update est utilisé pour mettre à jour les utilisateurs d'une licence en volume.

Paramètres :

  • licensekey clé de licence pour mettre à jour, dans ce format : AAAA-BBBB-CCCC-DDDD
  • /users : tout nombre de 1 à 50, ou "illimité"

Exemples :

AdminTool.exe /vl /update /users 2 AdminTool.exe /vl /update /users illimité

Pour plus d'informations, veuillez vous rendre sur Comment mettre à jour les utilisateurs d'une licence en volume depuis le serveur ?


Afficher les crédits de licence restants pour une clé de licence en volume : /vl /credits-license

Syntax :

AdminTool.exe /vl /credits-license [licensekey] [parameters]

Description :

Commande vl /credits-license est utilisé pour afficher les crédits de licence restants associés à une clé de licence en volume.

Paramètres :

  • licensekey Clé de licence en volume, dans ce format : AAAA-BBBB-CCCC-DDDD
  • /login fournir l'identifiant du partenaire associé à la clé de licence en volume
  • /edition fournir le paramètre d'édition optionnel pour les produits Advanced Security et Server Monitoring
  • /silent : exécute la commande silencieusement

La sortie sera stockée dans la variable d'environnement au niveau utilisateur nommée VOLUME_LICENSE_CREDITS Il peut être nécessaire de lire la valeur de VOLUME_LICENSE_CREDITS d'un processus différent, en utilisant la commande echo %VOLUME_LICENSE_CREDITS% .

Exemples :

AdminTool.exe /vl /credits-license VOLU-MELI-CENS-EKEY /login JOHNDOE TSplus-Security.exe /vl /credits-license VOLU-MELI-CENS-EKEY /login JOHNDOE /edition Essentials /silent

Pour plus d'informations, veuillez vous rendre sur Comment afficher les crédits de licence restants pour une clé de licence en volume ?


Afficher les crédits de support restants pour une clé de licence en volume : /vl /credits-support

Syntax :

AdminTool.exe /vl /credits-support [licensekey] [parameters]

Description :

Commande vl /credits-support est utilisé pour afficher les crédits de support restants associés à une clé de licence en volume.

Paramètres :

  • licensekey Clé de licence en volume, dans ce format : AAAA-BBBB-CCCC-DDDD
  • /login fournir l'identifiant du partenaire associé à la clé de licence en volume
  • /edition fournir le paramètre d'édition optionnel pour les produits Advanced Security et Server Monitoring
  • /silent : exécute la commande silencieusement

La sortie sera stockée dans la variable d'environnement au niveau utilisateur nommée VOLUME_LICENSE_CREDITS Il peut être nécessaire de lire la valeur de VOLUME_LICENSE_CREDITS d'un processus différent, en utilisant la commande echo %VOLUME_LICENSE_CREDITS% .

Exemples :

AdminTool.exe /vl /credits-support VOLU-MELI-CENS-EKEY /login JOHNDOE TSplus-Security.exe /vl /credits-support VOLU-MELI-CENS-EKEY /login JOHNDOE /edition Essentials

Pour plus d'informations, veuillez vous rendre sur Comment afficher les crédits de support restants pour une clé de licence en volume ?


2FA - réinitialiser : /resetuser

Syntax :

TwoFactor..Admin.exe /resetuser [user1] [user2] … [userN]

Description :

Commande /resetuser est utilisé pour réinitialiser les utilisateurs 2FA, au lieu de le faire via l'interface utilisateur (cela peut être fait ici dans l'interface : TwoFactor.Admin > Gérer les utilisateurs > Réinitialiser)

Paramètres :

  • user1 user2 ... userN les noms de domaine des utilisateurs que vous souhaitez réinitialiser (séparés par un espace simple)

Exemples :

TwoFactor.Admin.exe /resetuser johndoe jackrussell chuckbartowski

Pour plus d'informations, veuillez vous rendre sur Réinitialiser la configuration pour les utilisateurs


2FA - ajouter des utilisateurs : /addusers

Syntax :

TwoFactor.Admin.exe /addusers [userInfos1] [userInfos2] … [userInfosN]

Description :

Commande /addusers est utilisé pour ajouter plusieurs utilisateurs 2FA, au lieu de le faire via l'interface utilisateur, utilisateur par utilisateur (cela peut être fait ici dans l'interface : TwoFactor.Admin > Gérer les utilisateurs > Ajouter un utilisateur)

Paramètres :

  • userInfos1 userInfos2 ... userInfosN les informations utilisateur des utilisateurs que vous souhaitez ajouter. Ces informations se composent des champs suivants, séparés par un point-virgule.
    • domainName (mandatory): le nom de domaine de l'utilisateur à ajouter
    • receivedMethod méthode pour recevoir des codes de confirmation. Doit être l'une de ces valeurs : SMS, App, Email ou LaisserLUtilisateurChoisir. App est la valeur par défaut.
    • mobilePhone (optionnel) : le téléphone de l'utilisateur à ajouter
    • email (email de l'utilisateur à ajouter)

Exemples :

TwoFactor.Admin.exe /addusers johndoe jackrussell;LaissezL'utilisateurChoisir chuckbartowski;Téléphone;+33101010101; [email protected] samanthacarter;Email;;

Pour plus d'informations, veuillez vous rendre sur Ajouter des utilisateurs et des groupes


2FA - ajouter des groupes : /addgroups

Syntax :

TwoFactor.Admin.exe /addgroups [groupe1] [groupe2] … [groupeN]

Description :

Commande /addgroups est utilisé pour ajouter plusieurs groupes 2FA, au lieu de le faire via l'interface utilisateur, groupe par groupe (cela peut être fait ici dans l'interface : TwoFactor.Admin > Gérer les utilisateurs > Ajouter un groupe)

Paramètres :

  • group1 group2 ... groupN les noms des groupes que vous souhaitez ajouter.

Exemples :

TwoFactor.Admin.exe /addgroups groupe1 groupe2 groupe3

Pour plus d'informations, veuillez vous rendre sur Ajouter des utilisateurs et des groupes


2FA - lister les utilisateurs : /getusers

Syntax :

TwoFactor.Admin.exe /getusers

Description :

Commande /getusers est utilisé pour obtenir une liste de tous les utilisateurs/groupes configurés dans la console d'administration 2FA. Une représentation json de cette liste d'utilisateurs/groupes est renvoyée et peut être utilisée par exemple dans un script Powershell.

Cette liste peut être vue ici dans l'interface : TwoFactor.Admin > Gérer les utilisateurs.

Paramètres :

Aucun


2FA - ajouter des groupes : /deleteuser

Syntax :

TwoFactor.Admin.exe /deleteuser [domainName] [userType]

Description :

Commande /deleteuser est utilisé pour retirer un utilisateur de la configuration 2FA (cela peut être fait ici dans l'interface : TwoFactor.Admin > Gérer les utilisateurs > Retirer)

Paramètres :

  • domainName le nom de l'utilisateur ou du groupe à supprimer.
  • userType le type d'objet à supprimer. Sa valeur doit être "utilisateur" ou "groupe"

Exemples :

TwoFactor.Admin.exe /deleteuser “Ceci est un nom de groupe” groupe TwoFactor.Admin.exe /deleteuser administrateur utilisateur

Pour plus d'informations, veuillez vous rendre sur Supprimer les utilisateurs et les groupes