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
- Restaurer les données et les paramètres
- Serveur Web
- Mise à jour
- Appliquer les mises à jour de compatibilité Windows
- Installer l'imprimante universelle
- Supprimer l'imprimante universelle
- Configurer le serveur proxy
- Ouvrir le formulaire d'identifiants Web
- Créer des identifiants Web
- Supprimer les identifiants Web
- Gestionnaire de session ouverte
- Moniteur des sessions ouvertes
- Ouvrir le gestionnaire d'équilibrage de charge
- Exécuter un audit système
- Activation de la licence
- Réinitialisation de la licence suite au clonage d'une VM
- Activation de licence en volume
- Activer et désactiver la licence en volume
- Mise à jour de la licence en volume
- 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
- 2FA - réinitialiser
- 2FA - ajouter des utilisateurs
- 2FA - ajouter des groupes
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 :
- Une nouvelle licence TSplus doit être activée à l'aide d'une nouvelle clé d'activation.
- 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é :
-
Ouvrez une session Administrateur sur le serveur cloné.
-
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.
-
Renommez le serveur cloné et redémarrez-le.
-
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
- 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)."
- 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