4. Utiliser WAPT en ligne de commande

L’agent WAPT fournit un utilitaire d’interface de ligne de commande wapt-get.

L'invite de commande Windows

L’invite de commande Windows

Note

  • Par défaut, les actions en ligne de commande dans WAPT sont exécutées avec les droits de l’utilisateur qui a lancé le cmd.exe.

  • Si le cmd.exe n’a pas été lancé avec les privilèges d’un Administrateur Local, la commande sera transmise au waptservice.

  • Par sécurité, certaines actions demandent un identifiant et un mot de passe.

  • Seuls les Administrateurs Locaux et les membres du groupe de sécurité Active Directory waptselfservice sont autorisés.

  • Pour forcer l’utilisation du service WAPT en tant qu”Administrateur Local, ajouter simplement -S après wapt-get.exe.

Note

Chaque commande qui prend un nom de paquet comme paramètre peut également prendre le package_uuid unique du paquet comme paramètre (wapt-get install, wapt-get forget, etc.). L’utilisation d’un GUID permet de spécifier un paquet unique sans ambiguïté sur son architecture ou sa version. Le package_uuid est listé dans la sortie de wapt-get list et wapt-get search. Par exemple :

4.1. Utilisation des fonctions les plus courantes dans WAPT via ligne de commande

4.1.1. wapt-get install

La commande wapt-get install <package name> lance l’installation d’un paquet.

Pour installer Mozilla Firefox, la commande est wapt-get install tis-firefox.

Il est possible d’installer plusieurs paquets à la fois :

wapt-get install package1 package2

Si le paquet n’a pas été téléchargé dans le cache, wapt-get install téléchargera d’abord le paquet dans le cache, puis l’Agent WAPT installera le paquet.

Attention

Installer un paquet WAPT avec wapt-get install n’ajoute pas le paquet comme dépendance à la machine.

Le paquet est installé sur la machine, mais si l’ordinateur est réimagé, le paquet ne sera pas réinstallé automatiquement.

La commande wapt-get install tis-firefox renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
installing WAPT packages tis-firefox
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 14121562 / 54313787 (26%) (24624 KB/s)
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 33131357 / 54313787 (61%) (29414 KB/s)
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 50511741 / 54313787 (93%) (30412 KB/s)
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 54313787 / 54313787 (100%) (30360 KB/s)
Installing tis-firefox(=94.0.1-106)
Installing: Firefox_Setup_94.0.1.exe
Waiting for key key Mozilla Firefox 94.0.1 (x64 en-US) to appear in Windows registry
Delete C:\Program Files (x86)\wapt\cache\tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt

Results:

=== install packages ===
  tis-firefox [x64_en_PROD]     | tis-firefox (94.0.1-106)                   | tis-firefox (50.0.2-73)

4.1.2. wapt-get update

La commande wapt-get update permet de mettre à jour la liste des paquets disponibles.

L’agent WAPT local téléchargera le fichier Packages du dépôt privé et le comparera à sa base de données locale.

  • Si de nouvelles mises à jour sont disponibles, l’agent WAPT fait passer le statut des paquets à TO-UPGRADE.

  • Si de nouveaux logiciels ont été ajoutés sur le dépôt, ils deviennent disponibles pour le téléchargement par l’Agent WAPT.

Note

La commande wapt-get update ne télécharge pas les paquets, elle met seulement à jour la base de données locale des paquets.

La commande wapt-get update renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
Update package list from https://srvwapt.mydomain.lan/wapt, https://srvwapt.mydomain.lan/wapt-host
Total packages: 8
Added packages:

Removed packages:

Discarded packages count: 6
Pending operations:
  install:
  upgrade:
  additional:
  remove:
  immediate_installs:
Repositories URL :
  https://srvwapt.mydomain.lan/wapt
  https://srvwapt.mydomain.lan/wapt-host

4.1.3. wapt-get upgrade

La commande wapt-get upgrade lance l’installation des paquets WAPT en attente de mise à niveau ou en attente d’installation.

L’agent WAPT local télécharge d’abord ses paquets WAPT dans le cache local, puis l’agent WAPT les installe.

Indication

Il est recommandé de lancer la commande wapt-get update avant de lancer une commande wapt-get upgrade.

Sans le lancement préalable d’un update, l’agent WAPT n’installera rien.

La commande :code :wapt-get upgrade renvoie :

Installing tis-mumble
Shutting down Mumble
installing Mumble 1.2.3

=== install packages ===
tis-mumble

4.1.4. wapt-get remove

La commande wapt-get remove <nom du paquet> supprime les paquets WAPT listés de la machine.

La commande prend un argument. Cet argument est le nom paquet ou une liste de noms de paquets avec le préfixe du dépôt.

Pour supprimer Mozilla Firefox, la commande est wapt-get remove <prefix>-firefox.

Attention

La suppression d’un paquet WAPT avec remove ne supprime pas la dépendance du paquet sur l’hôte.

Le paquet sera effectivement désinstallé de la machine, mais il sera automatiquement réinstallé lors de la prochaine mise à jour

Pour supprimer complètement un paquet d’un hôte, faites un wapt-get remove pour le paquet ciblé, puis modifiez la configuration de l’hôte via la console WAPT pour supprimer la dépendance du paquet sur l’hôte.

La commande wapt-get remove tis-firefox renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
Removing tis-firefox ...

Waiting for the removal of key key Mozilla Firefox 94.0.1 (x64 en-US) from Windows registry
=== Removed packages ===
  tis-firefox

4.1.5. wapt-get uninstall

La commande wapt-get uninstall [<nom du paquet>] désinstalle les paquets listés de la machine si une fonction def uninstall() existe dans les fichiers setup.py des paquets listés.

La commande prend un argument. Cet argument est le nom paquet ou une liste de noms de paquets avec le préfixe du dépôt.

Attention

Exécuter la fonction de désinstallation du paquet ne supprime pas le paquet en cache sur la machine.

La commande wapt-get uninstall tis-adwcleaner renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
 Uninstalling tis-adwcleaner ...
 None
 Uninstallation done

4.1.6. wapt-get forget

La commande wapt-get forget <nom du paquet> supprime le paquet de la base de données locale afin que le cycle de vie du logiciel ou de la configuration ne soit plus géré par WAPT.

La commande prend un argument. Cet argument est le nom paquet ou une liste de noms de paquets avec le préfixe du dépôt.

Attention

Oublier le paquet WAPT ne désinstalle pas le logiciel ni la configuration associée au paquet WAPT.

La commande wapt-get forget tis-adwcleaner renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini

=== Packages removed from status ===
  tis-adwcleaner

4.1.7. wapt-get audit

La commande wapt-get audit [<nom du paquet>] exécute la fonction d’audit pour les paquets listés si une fonction def audit() existe dans les fichiers setup.py des paquets listés.

La commande prend un argument. Cet argument est le nom paquet ou une liste de noms de paquets avec le préfixe du dépôt.

De même, la commande wapt-get audit ALL exécute la fonction d’audit pour tous les paquets installés sur la machine.

La commande wapt-get audit tis-firefox renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
Auditing tis-firefox ...
Auditing tis-firefox
OK: Uninstall Key Mozilla Firefox 94.0.1 (x64 en-US) in Windows Registry.
tis-firefox -> OK

4.1.8. wapt-get show

La commande wapt-get show <nom du paquet> affiche les informations stockées dans le fichier d’index Packages.

Si plusieurs versions d’un paquet WAPT sont disponibles sur le dépôt WAPT, chaque version du paquet sera affichée.

La commande wapt-get show tis-7zip renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
Display package control data for tis-7zip

package           : tis-7zip
version           : 19.00-25
architecture      : x64
section           : base
priority          : optional
name              : 7-Zip
categories        : Utilities
maintainer        : WAPT Team,Tranquil IT,Jimmy PELÉ
description       : 7-Zip is a free and open-source file archiver with a high compression ratio
depends           :
conflicts         :
maturity          : PROD
locale            : all
target_os         : windows
min_wapt_version  : 1.7
sources           : https://www.7-zip.org/download.html
installed_size    :
impacted_process  : 7zFM,7z,7zG
description_fr    : 7-Zip est un logiciel gratuit et open source pour archiver des fichiers avec un taux de compression élevé
description_pl    :
description_de    : 7-Zip ist ein Datenkompressionsprogramm mit einer hohen Kompressionsrate
description_es    : 7-Zip es un archivador de ficheros con una alta relación de compresión
description_pt    : O 7-Zip é um compactador de arquivos com alta taxa de compressão
description_it    :
description_nl    :
description_ru    : 7-Zip свободный файловый архиватор с высокой степенью сжатия данных
audit_schedule    :
editor            : Igor Pavlov
keywords          : 7zip,7,zip,7-zip,file,archiver,high,compression,ratio
licence           : LGPL
homepage          : https://www.7-zip.org/
package_uuid      : dc66ccd1-d987-482e-b792-04e89a3803f7
valid_from        :
valid_until       :
forced_install_on :
changelog         : https://www.7-zip.org/history.txt
min_os_version    : 5.0
max_os_version    :
icon_sha256sum    : eddc038d3625902b6ddeaabd13dd91529e8d457ffbd0c554f96d343ae243a67a
signer            : documentation
signer_fingerprint: 3f2c0a02231a36eafa1f67905f5c083e4b66cb59942f69cbd231d778a1a25b3d
signature         : QzhPeZFrRbjcGzfqRpoWsDP9Plaz6BBVlL3adq/MRM19D61+Aez/JiA8skriCgwSErJXbxOPfxusVqqIpEtyoqh/RlRcnmgCQqk2Fig4gmxpz0rHKokukPQlRk+HdC/uByxSjfp9oXuB3PVG2PZAFifjVBtjEX2QmV+OY6NdMI9dtkxCsn1Xotn2qhu2bwbJWQ0s51rD9emWuQR7l/8WXl+HoquuRho4aCeAOYd6Nta9ktVSR2FM6OO5ZeUOg4fsnMg+hwp2MlDOmBHX37aJm3hLYkGP2xWjpL9YDDxI7ruRXSHyT7YmbILrS0h1m3PTOiV8jy1hTLDgKVeptPWVgA==
signature_date    : 2021-11-19T16:15:42.019196
signed_attributes : package,version,architecture,section,priority,name,categories,maintainer,description,depends,conflicts,maturity,locale,target_os,min_wapt_version,sources,installed_size,impacted_process,description_fr,description_pl,description_de,description_es,description_pt,description_it,description_nl,description_ru,audit_schedule,editor,keywords,licence,homepage,package_uuid,valid_from,valid_until,forced_install_on,changelog,min_os_version,max_os_version,icon_sha256sum,signer,signer_fingerprint,signature_date,signed_attributes
filename          : tis-7zip_19.00-25_x64_windows_0f4137ed1502b5045d6083aa258b5c42_5.0_PROD_a10c57d7848cf7b145d6cd64bf4d5389.wapt
size              : 1704227
md5sum            : a10c57d7848cf7b145d6cd64bf4d5389

OK Package control signature checked properly by certificate documentation (fingerprint: 3f2c0a02231a36eafa1f67905f5c083e4b66cb59942f69cbd231d778a1a25b3d )

Note

WARNING: control data signature can not be validated with certificates [<SSLCertificate cn='documentation' fingerprint=3f2c0a issuer='documentation' validity=2021-11-19 - 2031-11-17 Code-Signing=True CA=True>]

Si ce message apparaît, c’est que le certificat n’est pas fiable.

Si vous voulez vérifier le paquet correctement, téléchargez-le dans le cache et exécutez la commande wapt-get show sur le paquet local.

Par exemple :

wapt-get download tis-7zip
wapt-get show "C:\Program Files (x86)\wapt\cache\tis-7zip_19.00-25_x64_windows_0f4137ed1502b5045d6083aa258b5c42_5.0_PROD_a10c57d7848cf7b145d6cd64bf4d5389.wapt"

4.1.9. wapt-get show-params

La commande wapt-get show-params <nom du paquet> renvoie une liste de paramètres qui seraient transmis à la commande wapt-get install <nom du paquet> --params=PARAMS.

La commande prend un argument. Cet argument est le nom paquet ou une liste de noms de paquets avec le préfixe du dépôt.

La commande wapt-get show-params tis-7zip renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
tis-7zip : {True, 'documentation': True}

4.1.10. wapt-get show-log

La commande wapt-get show-log <nom du paquet> renvoie les derniers journaux d’audit déposés dans la base de données sqlite locale de l’Agent WAPT.

La commande prend un argument. Cet argument est le nom paquet ou une liste de noms de paquets avec le préfixe du dépôt.

La commande wapt-get show tis-7zip renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
Package: tis-7zip (21.06-34) PROD
-------------------
Status: OK

Installation log:
-------------------
Installing: 7z2106-x64.msi
Waiting for key key {23170F69-40C1-2702-2106-000001000000} to appear in Windows registry

Installation Parameters:
-------------------
{}

Last audit:
-------------------
Status: OK
Date: 2022-01-06T10:32:38.698272

Output:
Auditing tis-7zip
OK: Uninstall Key {23170F69-40C1-2702-2106-000001000000} in Windows Registry.

Next audit on: 2022-01-06T10:32:38.698272

4.1.12. wapt-get download

La commande wapt-get download <nom du paquet> télécharge le paquet WAPT dans le cache local.

La commande wapt-get download tis-7zip renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
Downloading packages tis-7zip(=19.00-25)
https://srvwapt.mydomain.lan/wapt/tis-7zip_19.00-25_x64_windows_0f4137ed1502b5045d6083aa258b5c42_5.0_PROD_a10c57d7848cf7b145d6cd64bf4d5389.wapt : 1704227 / 1704227 (100%) (11804 KB/s)

Downloaded packages:
  C:\Program Files (x86)\wapt\cache\tis-7zip_19.00-25_x64_windows_0f4137ed1502b5045d6083aa258b5c42_5.0_PROD_a10c57d7848cf7b145d6cd64bf4d5389.wapt

4.1.13. wapt-get download-upgrade

La commande wapt-get download-upgrade télécharge les paquets à mettre à niveau dans le cache WAPT local.

La commande wapt-get download-upgrade renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 18466658 / 54313787 (34%) (32089 KB/s)
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 36390179 / 54313787 (67%) (32693 KB/s)
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 52684289 / 54313787 (97%) (31564 KB/s)
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 54313787 / 54313787 (100%) (30747 KB/s)

=== downloaded packages ===
  C:\Program Files (x86)\wapt\cache\B8D346E7-DDDB-0013-5A8A-425CF3B6199E.wapt
  C:\Program Files (x86)\wapt\cache\tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt

4.1.14. wapt-get list

La commande wapt-get list liste les paquets WAPT qui sont installés sur l’ordinateur.

La commande wapt-get list renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
package                              version    install_status install_date     description                                                                      package_uuid
------------------------------------ ---------- ---------- ---------------- -------------------------------------------------------------------------------- ------------------------------------
tis-7zip                            21.06-34   OK         2021-12-10T14:57 7-Zip is a free and open-source file archiver with a high compression ratio      717a30cc-0d44-42d1-9538-0f2f298d8603
tis-firefox                         94.0.1-106 OK         2021-12-10T14:58 Mozilla Firefox is a free and open-source web browser                            5a91f54a-3e27-44cf-a2b6-6b84012aa3a2

package

version

install status

install_date

Description

package_uuid

Nom du paquet

Version du paquet

Installation status

Date et heure de l’installation

Description du paquet

UUID unique du paquet

4.1.15. wapt-get list-upgrade

La commande wapt-get list-upgrade liste les paquets WAPT qui doivent être mis à niveau sur la machine.

La commande wapt-get list-upgrade renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini

=== upgrade packages ===
tis-notepadplusplus(=8.2-10)

4.1.16. wapt-get -S tasks

La commande wapt-get -S tasks vérifie si certaines tâches sont en cours d’exécution ou en attente dans la file d’attente.

La commande wapt-get -S tasks renvoie :

About to speak to waptservice...
Running task 14: Uninstall of tis-vlc (task #14), status:

4.2. Utilisation de lignes de commande spéciales avec WAPT

4.2.1. wapt-get restart-waptservice

La wapt-get restart-waptservice redémarre le waptservice sous Windows, Linux et macOS.

4.2.2. wapt-get add-config-from-url

La commande wapt-get add-config-from-url <filelink> <sha256hashfile> récupère un fichier de configuration dynamique json depuis l’url spécifiée et place le fichier dans le répertoire conf.d sous le dossier d’installation de wapt.

Le paramètre <sha256hashfile> est facultatif.

C:\Users\administrator>wapt-get add-config-from-url https://srvwapt.mydomain.lan/wapt/conf.d/default_config_55863a6b54a47255097b6403731b36de716fc7ee9ec824bffad36d5fdc49b6b5.json
New config installed as C:\Program Files (x86)\wapt\conf.d\default.json

4.2.3. wapt-get add-config-from-file

La commande wapt-get add-config-from-file <filepath> ajoute un fichier de configuration dynamique json dans le répertoire conf.d sous le dossier d’installation de wapt.

Le chemin d’accès au fichier de configuration dynamique json est défini par <filepath>.

4.2.4. wapt-get add-config-from-base64

La commande wapt-get add-config-from-file <base64 file> ajoute un fichier de configuration dynamique json dans le répertoire conf.d sous le dossier d’installation de wapt.

Le chemin d’accès au fichier de configuration dynamique json est défini par <fichier bbase64>.

4.2.5. wapt-get remove-config

La commande wapt-get remove-config <config-name> supprime les fichiers de configuration dynamique json spécifiés du dossier conf.d sous le dossier d’installation de wapt.

4.2.6. wapt-get list-config

La commande wapt-get list-config liste les fichiers de configuration dynamique json installés qui sont présents dans le dossier conf.d sous le dossier d’installation de wapt.

C:\Users\administrator>wapt-get list-config
Using config file: C:\Program Files (x86)\wapt\wapt-get.ini

config files are located in C:\Program Files (x86)\wapt\conf.d

* config_base

4.2.7. wapt-get list-available-config

La commande wapt-get list-available-config liste tous les fichiers de configuration dynamique json disponibles sur le Serveur WAPT et indique la commande pour les installer.

Lister les configurations disponibles nécessite que l’utilisateur soit authentifié.

C:\Users\administrator>wapt-get list-available-config
Server: https://srvwapt.mydomain.lan
Server UUID: 32464dd6-c261-11e8-87be-cee799b43a00
Server CABundle: 0

Waptserver https://srvwapt.mydomain.lan Admin User () :admin
Waptserver Password: *************

default_config : wapt-get add-config-from-url https://srvwapt.mydomain.lan/wapt/conf.d/default_config_55863a6b54a47255097b6403731b36de716fc7ee9ec824bffad36d5fdc49b6b5.json
     Server: https://srvwapt.mydomain.lan
     Repo: https://srvwapt.mydomain.lan/wapt

default : wapt-get add-config-from-url https://srvwapt.mydomain.lan/wapt/conf.d/default_91ab2cd1901b5e36214224229c3461e49e65f7b065ea6b0eb16bd83c7fcdda57.json
     Server: https://srvwapt.mydomain.lan
     Repo: https://srvwapt.mydomain.lan/wapt

mac_config : wapt-get add-config-from-url https://srvwapt.mydomain.lan/wapt/conf.d/mac_config_2720657c276cbc0ee14734e68fbd0fadc4dea3171625406e10cd9828631e5c72.json
     Server: https://srvwapt.mydomain.lan
     Repo: https://srvwapt.mydomain.lan/wapt

4.2.8. wapt-get clean

La commande wapt-get clean supprime les paquets du dossier cache.

La commande est lancée après chaque wapt-get upgrade pour économiser de l’espace disque.

La commande wapt-get clean renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
Removed files:
C:\Program Files (x86)\wapt\cache\tis-mumble_1.2.3-1_all.wapt
C:\Program Files (x86)\\wapt\cache\tis-vlc_1.2.3-2_all.wapt

4.2.9. wapt-get upgradedb

La commande wapt-get upgradedb met à jour le schéma de la base de données WAPT locale si nécessaire.

La commande wapt-get upgradedb renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
WARNING upgrade db aborted: current structure version 20210420 is newer or equal to requested structure version 20210420
No database upgrade required, current 20210420, required 20210420

4.2.10. wapt-get add-upgrade-shutdown - wapt-get remove-upgrade-shutdown

Ces 2 commandes modifient le C:\Windows\System32\GroupPolicy\Machine\Scripts\scripts.ini sur les appareils Windows.

  • La commande wapt-get add-upgrade-shutdown ajoute un objet de stratégie de sécurité locale waptexit, permettant l’exécution de waptexit à l’arrêt du système.

La commande wapt-get add-upgrade-shutdown renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
0

Le scripts.ini contient :

[Shutdown]
0CmdLine = C:\Program Files (x86)\wapt\waptexit.exe
0Parameters =
  • La commande wapt-get remove-upgrade-shutdown supprime l’objet de politique de sécurité locale waptexit, désactivant l’exécution de waptexit pendant l’arrêt du système.

La commande wapt-get add-upgrade-shutdown renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
0

Le scripts.ini contient :

[Shutdown]

4.2.11. wapt-get register

La commande wapt-get register <description> envoie l’inventaire du matériel et des logiciels de l’ordinateur au Serveur WAPT.

Le paramètre <description> est facultatif.

Indication

Une description peut être passée comme argument à la commande wapt-get register, la description sera affichée dans la console WAPT dans la colonne description.

Vous pouvez bénéficier de WAPT pour améliorer votre gestion informatique en affectant une étiquette d’inventaire comme description pour vos machines par exemple.

Note

Si la machine est déjà enregistrée, le réenregistrement de la machine à l’aide d’une description met à jour les informations enregistrées.

La commande wapt-get register "John Doe PC" renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
Registering host against server: https://srvwapt.mydomain.lan
Host correctly registered against server https://srvwapt.mydomain.lan.

4.2.12. wapt-get unregister

La commande wapt-get unregister supprime l’inventaire matériel et logiciel de la machine du Serveur WAPT.

La commande wapt-get unregister renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
Unregistering host from server: https://srvwapt.mydomain.lan
Please get login for api/v3/hosts_delete:admin
Password:
Host correctly unregistered against server https://srvwapt.mydomain.lan.

4.2.13. wapt-get inventory

La commande wapt-get inventory affiche les informations d’inventaire de la machine au format json.

La commande wapt-get inventory renvoie (en partie) :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
{
  "host_info": {
    "description": "John Doe PC",
    "system_manufacturer": "Xen",
    "system_productname": "HVM domU",
    "computer_name": "Documentation",
    "computer_fqdn": "Documentation.srvwapt.mydomain.lan",
    "dnsdomain": "mydomain.lan",
    "workgroup_name": "Documentation",
    "domain_name": null,
    "domain_controller": null,
    "domain_controller_address": null,
    "domain_info_source": "history",
    "networking": [
    {
      "iface": "{085AB96368A-05A3B96-43EC-B773-0C0BB96794D9}",
      "mac": "a2:1d:6e:fc:8d:e6",
      "addr": [
      {
        "addr": "192.168.0.1",
        "netmask": "255.255.255.0",
        "broadcast": "192.168.0.255",
        "connected": true
      },
      {
        "addr": "fe80::2437:567f:79c8:f964",
        "netmask": "ffff:ffff:ffff:ffff::/64",
        "broadcast": "fe80::ffff:ffff:ffff:ffff%3",
        "connected": true
      }
      ]
    }
    ],
    "gateways": [
    "192.168.0.254"
    ],
    "dns_servers": [
    "192.168.0.11"
    ],
    "connected_ips": [
    "192.168.0.1",
    "fe80::2437:567f:79c8:f964"
    ],
    "mac": [
    "a2:fc:1d:6e:8d:e6"
    ],
...

4.2.14. wapt-get update-status

La commande wapt-get update-status envoie l’état actuel de la machine au Serveur WAPT.

Note

Si un composant matériel a été modifié sur l’ordinateur, le update-status ne renvoie pas cette information au serveur d’inventaire WAPT.

Pour ce faire, la commande à utiliser est wapt-get inventory.

La commande wapt-get update-status renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
Updated host status correctly sent to the WAPT Server https://srvwapt.mydomain.lan. {'success': True, 'msg': 'update_host', 'result': {'uuid': 'B8D346E7-DDDB-0013-5A8A-425CF3B6199E', 'computer_fqdn': 'documentation.mydomain.lan', 'status_hashes': {'dmi': '124b8bcef5b690afea7cf8001351a22132885123', 'wmi': 'ae5dbb5627b7b3a5a31d5914a9dbf48b85b133da', 'host_info': 'e737a82da15fbe9cae88ba9b4a9662a73657d959', 'audit_data': None, 'wapt_status': 'bcb76ad07cf1b6f814082ec5a58c4fee0364a640', 'audit_status': 'c34adb535c711b59d4408f00f77b7392687d7e56', 'host_metrics': '9fc68bd98c82e0e9bece0ce3afaeeb63a3ed1db1', 'waptwua_status': '4f9dcf0af339ce28d7354283fd4e6bdaf17b85c8', 'waptwua_updates': 'c5cf38908fc549f499ade5b17ce221ff0ced377f', 'wuauserv_status': '7c30215c3c34566e5b0c69c9e1dbfe3e6117b837', 'host_capabilities': 'c31286122a213f3bb313531541582bb2ba1d0a81', 'installed_packages': '3279f3bf4d5ed5086b198fa94a6a6f422f519ab3', 'last_update_status': '347c5a8c01e182f1e03e5c9d0fe07dd87ab79153', 'installed_softwares': 'd582a6f7325af35eae17cb7ecdca59ef0d137dda', 'authorized_certificates': '2974f9535f813fc454b735193c31828b132a6ba0', 'waptwua_updates_localstatus': 'c5cf38908fc549f499ade5b17ce221ff0ced377f'}, 'server_uuid': '82295c4d-4944-11ec-bac6-a25b5d7da3d5'}, 'request_time': 0.046843767166137695}

4.2.15. wapt-get setlocalpassword

La commande wapt-get setlocalpassword permet de définir un mot de passe local pour l’installation des paquets WAPT.

La commande wapt-get setlocalpassword renvoie :

Local password:
Confirm password:
Local auth password set successfully

4.2.16. wapt-get reset-uuid

La commande wapt-get reset-uuid récupère le UUID de la machine à partir du BIOS et l’envoie au Serveur WAPT.

La commande wapt-get reset-uuid renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
New UUID: B0F23D44-86CB-CEFE-A8D6-FB8E3343FE7F

4.2.17. wapt-get generate-uuid

La commande wapt-get generate-uuid génère un UUID aléatoire pour la machine et le renvoie au Serveur WAPT.

La wapt-get generate-uuid est utile s’il existe des bugs de BIOS avec certaines machines de la flotte.

La commande wapt-get generate-uuid renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
New UUID: RND-0279A1F4-BBBE-43AE-A591-F82652E0104B

Note

Tous les UUID générés aléatoirement commencent par RND-.

4.2.18. wapt-get get-server-certificate

La commande wapt-get get-server-certificate télécharge le certificat SSL du Serveur WAPT afin que l’Agent WAPT puisse établir une connexion HTTPS sécurisée avec le Serveur WAPT.

Le certificat téléchargé est déposé dans <wapt>\ssl\server.

La commande wapt-get get-server-certificate renvoie :

Server certificate written to C:\Program Files (x86)\wapt\ssl\server\srvwapt.mydomain.lan.crt

4.2.19. wapt-get enable-check-certificate

La commande wapt-get enable-check-certificate télécharge le certificat SSL du serveur WAPT et active la communication sécurisée avec le serveur.

La commande wapt-get enable-check-certificate est utilisée pour activer la vérification du certificat SSL / TLS.

La commande wapt-get enable-check-certificate renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
Server certificate : C:\Program Files (x86)\wapt\ssl\server\template-auto.test.lan.crt
Certificate CN: template-auto.test.lan
Pining certificate C:\Program Files (x86)\wapt\ssl\server\template-auto.test.lan.crt

4.2.20. wapt-get check-upgrades

La commande wapt-get check-upgrades indique l’état de la mise à jour / mise à niveau la plus récente pour la machine.

La commande wapt-get check-upgrades renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
{
  "running_tasks": [],
  "errors": [],
  "date": "2022-01-06T14:09:26.554391",
  "upgrades": [
    "tis-notepadplusplus(=8.2-10)"
  ],
  "pending": {
    "install": [],
    "upgrade": [
    "tis-notepadplusplus(=8.2-10)"
    ],
    "additional": [],
    "remove": [],
    "immediate_installs": []
  }
}

4.2.21. wapt-get add-licence

La commande wapt-get add-licence ajoute une licence WAPT sur le Serveur WAPT.

La commande wapt-get add-licence renvoie :

Using config file C:\Program Files (x86)\wapt\wapt-get.ini
Server: https://srvwapt.mydomain.lan
Server UUID: 82295c4d-4944-11ec-bac6-a25b5d7da3d5
Server CABundle: 0

{"licence_nr":"6f011e23-cb70-40a4-b340-0d18ae1e2f02","product":"WAPT Enterprise","features":["full"],"licenced_to":"documentation","domain":"","contact_email":"documentation@tranquil.it","count":"10","valid_from":"2021-06-14T00:00:0","valid_until":"2022-01-12T00:00:0","renewal_url":null,"signed_attributes":["licence_nr","product","features","licenced_to","domain","contact_email","count","valid_from","valid_until","renewal_url","signed_attributes","signer","signature_date","signer_certificate","server_uuid"],"signer":"","signature_date":"2022-01-13T16:38:56","signer_certificate":"-----BEGIN CERTIFICATE-----\nMIIEIjCCAwqgAwIBAgIUIOMdx8FmRdmCNTHxOfKecSp/cAAwDQYJKoZIhvcNAQEL\nBQAwgZcxCzAJBgNVBAYTAkZSMSIwIAYDVQQHDBlTYWludCBTZWJhc3RpZW4gc3Vy\nIExvaXJlMRwwGgYDVQQKDBNUcmFucXVpbCBJVCBTeXN0ZW1zMSAwHgYDVQQDDBdy\nZWxpY2VuY2luZy50cmFucXVpbC5pdDEkMCIGCSqGSIb3DQEJARYVdGVjaG5pcXVl\nQHRyYW5xdWlsLml0MB4XDTIxMDYwODE0MTQ0MVoXDTMxMDYwNjE0MTQ0MVowgZcx\nCzAJBgNVBAYpk6dZrIrw9Kb5hee+1EgqEbudCBTZWJhc3RpZW4gc3VyIExvaXJl\nMRwwGgYDVQQKDBNUcmFucXVpbCBJVCBTeXN0ZW1zMSAwHgYDVQQDDBdyZWxpY2Vu\nY2luZy50cmFucXVpbC5pdDEkMCIGCSqGSIb3DQEJARYVdGVjaG5pcXVlQHRyYW5x\ndWlsLml0MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAzT43W8OhWXAe\nhDB+IWwQm9IGGdR0VY/klKcSheo/8jGlNziyH6BANhjFKYNX9UtQ+ghzv6BGfSTH\nyua1aXEQM89sSKFOoJztoD1L9FZtuWQb/vfLWkisP8fRPvH4B/tYG+5nchGa6+6r\nqGSGSpWcnj6CovgQR01ATUuHN3NV1N7q48hBT/ZT9R5U3sEi+hNK4eRIeZ220Pzm\nDoNGkVKlEiczgXuM77ezYp8UWvpk6dZrIrw9Kb5hee+1EgqEbgVmdARoaOPGTK8h\n8VW+milWsl4TEY19kxXWvva+M6wX00ipJ2LxEiu5+dlOok9E8i405UTNE7oSVYsF\n90/6S3C4twIDAQABo2QwYjAPBgNVHRMBAf8EBTADAQH/MCAGA1UdJQEB/wQWMBQG\nCCsGAQUFBwMDBggrBgEFBQcDAjAdBgNVHQ4EFgQUpRT6Co2uoWZMCwP7FKiF73+j\nfAEwDgYDVR0PAQH/BAQDAgHWMA0GCSqGSIb3DQEBCwUAA4IBAQAdXX5IkpuH/Gek\nPPHC4KvE/6GsU0kqLI1w5ML5pbF1zyCCL0nm4f8w2JJIJ2Ycdb4QVD27kJqgZcH1\nniYQ3RCIh6aasS8qpCOf90KkpvKMJiyk/ra7I6NSgPut4ErkoxUWocgF6SNFEjwB\naqUZY//Hkoqk2dXqdujLVGJfBpX95ZJ9PmFNLfsyUsvu1WcFMb0En0EUO74Mq4M3\nKo2S86G9pEDKooaN5Vq19biReOwQYpX1YlSLtrxFx8AM87auQgaD8EWSdA1q2ycN\n8ZnmXGxAhDv8hmE2Fv0x0t3hzYXxxcv1ZjYWRHlMUl/buWQQ35u9MFkjh7YZlTlM\nb9wjtN+W\n-----END CERTIFICATE-----\n","signature":"J7DZ+mja7zGghYFCDKh8WIxzzdhKPeoNswWjnKZziT+ddpoRdg45kZz4E8PxMIUzhTI8WIxzzdhKPeoNswrICpQ8t5kepzovZpoONwjgOQ5PoCAgDOE3NV+larFrMdkAjCpx4tV86n5gyXHJnlnH1OXCpKUBiIiP/de18bEgSSlgjXgE/wr2ZfclsRsRRfsRbGSterRKQcthNDrFlf8RjH5cpDnDvMJ+qJtTsqxA13/WT2NS2uNWZI93si/9mowWY8MdT/PZjosciCqijbq4oa+/FrPsALhUOtcGE9JylwknszUD5Ayfh+9sNLLxsG6eT0JlnNgf4nx9mXAu4GBg==","server_uuid":"82295c4d-4944-11ec-bac6-a25b5d7da3d5"}
Login to server api/v3/licences
Waptserver https://srvwapt.mydomain.lan Admin User () :admin
Waptserver Password: ************
Licence properly activated on server

4.2.22. wapt-get check-licences

La commande wapt-get check-licences montre les licences enregistrées sur le Serveur WAPT.

La commande wapt-get check-licences renvoie :

Using config file C:\Program Files (x86)\wapt\wapt-get.ini
Server: https://srvwapt.mydomain.lan
Server UUID: 36bf01bc-c8f5-11eb-bf04-36127be97253
Server CABundle: 0

Total licences count: 10
Licenced to: documentation

Valid Nr:b7b6e537-3cb7-4d9a-3cb7-2448020e2e51 Count:10 From:2022-01-13T00:00:0 Expire:2023-01-12T23:59:0 Server:36bf01bc-c8f5-11eb-bf04-36127be97253 Licencee:documentation

4.2.23. wapt-get dnsdebug

La commande wapt-get dnsdebug affiche les données de configuration réseau de la machine, notamment les données locales DNS liées à WAPT.

La commande wapt-get dnsdebug renvoie :

DNS Server : dns.mydomain.lan
DNS Domain : mydomain.lan
Main repo url: https://srvwapt.mydomain.lan/wapt
wapt SRV: []
waptserver SRV: []
CNAME: []

4.3. Utilisation de la ligne de commande pour la configuration de la session utilisateur

4.3.1. wapt-get session-setup

La commande wapt-get session-setup <nom du paquet> [<ALL>] lance les personnalisations de niveau utilisateur des paquets WAPT installés.

La commande wapt-get session-setup exécute la fonction def session_setup() définie dans le fichier setup.py du paquet WAPT si la fonction existe.

Note

L’argument ALL lancera session-setup pour tous les paquets WAPT installés.

La commande wapt-get session-setup ALL renvoie :

Configuring tis-7zip ... No session-setup. Done
Configuring tis-ccleaner ... Already installed. Done
Configuring tis-vlc ... No session-setup. Done
Configuring mdl-tightvnc ... No session-setup. Done
Configuring tis-brackets ... No session-setup. Done
Configuring mdl-firefox-esr ... No session-setup. Done
Configuring tis-paint.net ... No session-setup. Done

4.4. Utilisation de la ligne de commande pour créer des paquets WAPT

4.4.1. wapt-get list-registry

La commande wapt-get list liste les paquets WAPT qui sont installés sur l’ordinateur.

La commande peut prendre un argument insensible à la casse pour rechercher le mot-clé spécifié.

Les informations retournées sont :

Information

Définition

Disponible sur Windows

Disponible sur Linux

Disponible sur macOS

UninstallKey

Recherche l’identifiant de la clé de désinstallation dans la ruche du registre.

Fonctionnalité disponible

Fonctionnalité non disponible

Fonctionnalité non disponible

Software

Recherche le nom du logiciel dans la ruche du registre.

Fonctionnalité disponible

Fonctionnalité disponible

Fonctionnalité disponible

Version

Recherche la version du logiciel dans la ruche du registre.

Fonctionnalité disponible

Fonctionnalité disponible

Fonctionnalité disponible

Uninstallstring

Recherche la chaîne de désinstallation du logiciel dans la base de registre.

Fonctionnalité disponible

Fonctionnalité non disponible

Fonctionnalité non disponible

Note

  • Sous Windows, WAPT effectue des recherches dans deux emplacements du registre :

    • ComputerHKEY_LOCAL_MACHINESOFTWAREMicrosoftWindowsCurrentVersionUninstall.

    • ComputerHKEY_LOCAL_MACHINESOFTWAREWOW6432NodeMicrosoftWindowsCurrentVersionUninstall.

  • Sous Linux, WAPT effectue des recherches en utilisant Applications.

  • Sur macOS, WAPT recherche dans /var/lib/dpkg/info/.

La sortie de wapt-get list-registry est un tableau listant les clés de désinstallation pour chaque logiciel correspondant au terme recherché.

La commande wapt-get list-registry firefox renvoie (sous Windows) :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
UninstallKey                           Software                               Version             Uninstallstring
---------------------------------------------------------------------------------------------------------------------------------------------------------
Mozilla Firefox 45.5.0 ESR (x64 fr)    Mozilla Firefox 45.5.0 ESR (x64 fr)    45.5.0              "C:\Program Files\Mozilla Firefox\uninstall\helper.exe"

4.4.2. wapt-get sources

La commande wapt-get sources <nom du paquet> télécharge les sources depuis un dépôt de gestion du code source comme Git ou SVN.

La commande wapt-get sources tis-firefox ne renvoie rien ;

4.4.3. wapt-get make-template

Avertissement

Cette méthode est dépréciée, utilisez plutôt la console WAPT pour créer un modèle de packaging.

La commande wapt-get make-template <installer-path> [<packagename> [<source directoryname>]] permet de créer un modèle de paquet à partir d’un installateur msi ou exe.

La commande wapt-get make-template C:\Users\User\Downloads\tightvnc.msi tis-tightvnc renvoie :

Using config file: C:\Users\Documentation\AppData\Local\waptconsole\waptconsole.ini
Template created. You can build the WAPT package by launching
  C:\Program Files (x86)\wapt\wapt-get.exe build-package C:\waptdev\tis-tightvnc-wapt
You can build and upload the WAPT package by launching
  C:\Program Files (x86)\wapt\wapt-get.exe build-upload C:\waptdev\tis-tightvnc-wapt

Indication

  • Si vous avez préalablement installé le paquet tis-waptdev sur votre ordinateur de développement, l’éditeur PyScripter se lancera automatiquement et ouvrira le paquet en mode développement.

4.4.4. wapt-get make-host-template

Avertissement

Cette méthode est principalement destinée aux scripts, en général les paquets de la machine sont créés automatiquement avec la console WAPT.

La commande wapt-get make-host-template <nommachine> [[<paquet>,<paquet>,...] [répertoire]] crée un paquetage hôte WAPT vide à partir d’un modèle.

La commande wapt-get make-host-template host01.mydomain.lan renvoie :

Using config file: C:\Users\Documentation\AppData\Local\waptconsole\waptconsole.ini
Template created. You can build the WAPT package by launching
  C:\Program Files (x86)\wapt\wapt-get.exe build-package C:\waptdev\host01.mydomain.lan-wapt
You can build and upload the WAPT package by launching
  C:\Program Files (x86)\wapt\wapt-get.exe build-upload C:\waptdev\host01.mydomain.lan-wapt

4.4.5. wapt-get make-group-template

Avertissement

Cette méthode ne doit être utilisée que si vous ne pouvez pas utiliser la Console WAPT pour créer un paquet.

La commande wapt-get make-group-template <nom du groupe> crée un paquet WAPT group vide à partir d’un modèle.

La commande wapt-get make-group-template documentation renvoie :

Template created. You can build the WAPT package by launching
  C:\Program Files (x86)\wapt\wapt-get.exe build-package C:\waptdev\accounting-wapt
You can build and upload the WAPT package by launching
  C:\Program Files (x86)\wapt\wapt-get.exe build-upload C:\waptdev\accounting-wapt

4.4.6. wapt-get build-package

La commande wapt-get build-package <chemin vers le répertoire package> construit un paquet WAPT et le signe avec la clé privée de l”Administrateur.

Note

Le chemin vers la clé privée, le préfixe par défaut et le chemin de développement par défaut DOIVENT être correctement définis dans le fichier wapt-get.ini.

La commande wapt-get build-package c:waptdevtis-dropbox renvoie :

Using config file: C:\Users\documentation\AppData\Local\waptconsole\waptconsole.ini
Building packages 1 packages
Personal certificate is documentation
Please type the password to decrypt the private key C:\Users\documentation\private\documentation.pem
Password:
Private key is <SSLPrivateKey 'C:\\Users\\documentation\\private\\documentation.pem'>
Personal certificate is SSLCertificate cn=documentation
Private key is <SSLPrivateKey 'C:\\Users\\documentation\\private\\documentation.pem'>
Building c:\waptdev\tis-dropbox
Signing c:\waptdev\tis-dropbox with key <SSLPrivateKey 'C:\\Users\\documentation\\private\\documentation.pem'> and certificate documentation (C:\Users\documentation\private\documentation.crt)
Package c:\waptdev\tis-dropbox signed : signature : BN7j6lwloY...Iu9QVulA=
...done building. Package filename c:\waptdev\tis-dropbox_104.4.175-7_windows_0f4137ed1502b5045d6083aa258b5c42_5.1_PROD.wapt
1 packages successfully built
0 packages failed

You can upload to repository with
  C:\Program Files (x86)\wapt\wapt-get.exe upload-package "c:\waptdev\tis-dropbox_104.4.175-7_windows_0f4137ed1502b5045d6083aa258b5c42_5.1_PROD.wapt"

Avertissement

Le nom du répertoire ne définit pas le nom du paquet, ni son préfixe, ces valeurs sont définies par le fichier control.

4.4.7. wapt-get sign-package

La commande wapt-get sign-package <chemin vers le paquet> signe un paquet avec la clé privée de l”Administrateur.

Attention

wapt-get sign-package ne renomme pas le paquet WAPT avec le préfixe de l”Organization.

La commande wapt-get sign-package C:\waptdev\smp-7zip_16.4.0.0-1_all.wap renvoie :

Using config file: C:\Users\documentation\AppData\Local\waptconsole\waptconsole.ini
Signing packages c:\waptdev\tis-dropbox
Personal certificate is SSLCertificate cn=documentation
Please type the password to decrypt the private key C:\Users\documentation\private\documentation.pem
Password:
Private key is <SSLPrivateKey 'C:\\Users\\documentation\\private\\documentation.pem'>
Signing c:\waptdev\tis-dropbox
  OK: Package c:\waptdev\tis-dropbox signed : signature : b'nJYfYswDWi'...b'v790D7uA='

4.4.8. wapt-get build-upload

La commande wapt-get build-upload <chemin vers le paquet> construit et télécharge un paquet WAPT sur le dépôt WAPT principal.

Indication

En passant l’argument -i à wapt-get build-upload, le numéro de version du paquet WAPT est incrémenté avant que le paquet ne soit téléchargé, afin d’éviter de devoir modifier manuellement le fichier :control.

La commande wapt-get -i build-upload C:\waptdev\tis-tightvnc-wapt renvoie :

Using config file: C:\Users\documentation\AppData\Local\waptconsole\waptconsole.ini
Building packages 1 packages
Personal certificate is documentation
Please type the password to decrypt the private key C:\Users\documentation\private\documentation.pem
Password:
Private key is <SSLPrivateKey 'C:\\Users\\documentation\\private\\documentation.pem'>
Personal certificate is SSLCertificate cn=documentation
Private key is <SSLPrivateKey 'C:\\Users\\documentation\\private\\documentation.pem'>
Building c:\waptdev\tis-dropbox
Signing c:\waptdev\tis-dropbox with key <SSLPrivateKey 'C:\\Users\\documentation\\private\\documentation.pem'> and certificate documentation (C:\Users\documentation\private\documentation.crt)
Package c:\waptdev\tis-dropbox signed : signature : s9FOLFQvYw...c9T3Hv1A=
...done building. Package filename c:\waptdev\tis-dropbox_104.4.175-7_windows_0f4137ed1502b5045d6083aa258b5c42_5.1_PROD.wapt
1 packages successfully built
0 packages failed
Building and uploading packages to https://srvwapt.mydomain.lan
Please get login for https://srvwapt.mydomain.lan/api/v3/upload_xxx:admin
Password:
c:\waptdev\tis-dropbox_104.4.175-7_windows_0f4137ed1502b5045d6083aa258b5c42_5.1_PROD.wapt[================================] 126459984/126459984 - 00:00:40
Package uploaded successfully: 1 Packages uploaded, 0 errors

4.4.9. wapt-get duplicate

La commande wapt-get duplicate <source_package> <duplicated_package> duplique un paquet téléchargé depuis le dépôt et l’ouvre en tant que projet en utilisant l”IDE qui a été spécifié dans la configuration de la Console WAPT.

Avertissement

N’utilisez pas cette commande pour dupliquer un paquet host.

Arguments autorisés lors de la duplication d’un paquet WAPT.

Argument

Définition

Requis

<directory> ou <source_package>

Définit le chemin de répertoire vers le paquet WAPT ou le nom d’un paquet spécifique ayant une extension de fichier .wapt.

Fonctionnalité disponible

<duplicated_package>

Définit le nom du nouveau paquet.

Fonctionnalité disponible

<duplicated_package_version>

Change la version du paquet dans le fichier control. Si la version n’est pas définie, la même version est dupliquée.

Fonctionnalité non disponible

<duplicated_package_target_directory>

Définit le chemin d’accès au répertoire cible du paquet dupliqué. Si le répertoire cible n’est pas défini, le paquet dupliqué sera déposé dans le même répertoire que le paquet source.

Fonctionnalité non disponible

La commande wapt-get duplicate tis-firefox tis-firefox-custom renvoie :

Package duplicated. You can build the new WAPT package by launching
  C:\Program Files (x86)\wapt\wapt-get.exe build-package C:\waptdev\tis-firefox-custom-wapt
You can build and upload the new WAPT package by launching
  C:\Program Files (x86)\wapt\wapt-get.exe build-upload C:\waptdev\tis-firefox-custom-wapt

4.4.10. wapt-get edit

Avertissement

Cette méthode ne doit être utilisée que si vous ne pouvez pas utiliser la Console WAPT pour créer un paquet.

La commande wapt-get edit <nom du paquet> télécharge et ouvre le paquet dans un IDE pour le modifier.

La commande prend un argument. Cet argument est le nom paquet ou une liste de noms de paquets avec le préfixe du dépôt.

La commande wapt-get edit tis-firefox renvoie :

Using config file: C:\Users\documentation\AppData\Local\waptconsole\waptconsole.ini
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 1629411 / 54313787 (3%) (2686 KB/s)
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 8147055 / 54313787 (15%) (5679 KB/s)
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 15207836 / 54313787 (28%) (7367 KB/s)
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 19552932 / 54313787 (36%) (7249 KB/s)
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 24984302 / 54313787 (46%) (7471 KB/s)
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 29329398 / 54313787 (54%) (7143 KB/s)
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 33674494 / 54313787 (62%) (6951 KB/s)
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 40735275 / 54313787 (75%) (7534 KB/s)
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 45623508 / 54313787 (84%) (7326 KB/s)
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 53227426 / 54313787 (98%) (7603 KB/s)
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 54313787 / 54313787 (100%) (7663 KB/s)
Package edited. You can build and upload the new WAPT package by launching

Indication

  • Si vous avez préalablement installé le paquet tis-waptdev sur votre ordinateur de développement, l’éditeur PyScripter se lancera automatiquement et ouvrira le paquet en mode développement.

  • Vous pouvez éditer un paquet local en allant dans le dossier du paquet puis en tapant wapt-get edit ..

  • Une autre méthode, vous pouvez éditer un paquet local à partir de son nom de répertoire ou du nom du paquet wapt, exemple wapt-get edit tis-vlc.wapt.

4.4.11. wapt-get edit-host

Avertissement

Cette méthode ne doit être utilisée que si vous ne pouvez pas utiliser la Console WAPT pour créer un paquet.

La commande wapt-get edit-host <host FQDN> édite un paquet WAPT host.

La commande wapt-get edit-host RND-0279A1F4-BBBE-43AE-A591-F82652E0104B renvoie :

Using config file: C:\Users\documentation\AppData\Local\waptconsole\waptconsole.ini
Package edited. You can build and upload the new WAPT package by launching
C:\Program Files (x86)\wapt\wapt-get.exe -i build-upload c:\waptdev\RND-0279A1F4-BBBE-43AE-A591-F82652E0104B_0-wapt

4.4.12. wapt-get update-package-sources

La commande wapt-get update-package-sources <chemin vers le paquet> met à jour la fonction def update_package() dans le fichier :setup.py.

La commande wapt-get update-package-sources tis-firefox renvoie :

Using config file: C:\Users\documentation\AppData\Local\waptconsole\waptconsole.ini
Latis Mozilla Firefox version is: 95.0.2
Download URL is: https://download-installer.cdn.mozilla.net/pub/firefox/releases/95.0.2/win64/en-US/Firefox%20Setup%2095.0.2.exe
Downloading: Firefox_Setup_95.0.2.exe
Firefox_Setup_95.0.2.exe[================================] 54810424/54810424 - 00:00:07
Software version updated (from: 94.0.1 to: 95.0.2)
Packages updated :
c:\waptdev\tis-firefox_0-wapt

4.5. Utilisation des lignes de commande pour la gestion de WaptWUA Fonctionnalité WAPT Enterprise uniquement

4.5.1. wapt-get waptwua-scan

La wapt-get waptwua-scan analyse l’état des mises à jour de Windows par rapport aux règles actuelles et renvoie le résultat au Serveur WAPT.

La commande wapt-get waptwua-scan renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
Ensure wuauserv Auto Update option is disabled
Scanning with windows updates rules:
{
"direct_download": false,
"default_allow": false,
"filter": "Type='Software' or Type='Driver'",
"download_scheduling": "7d",
"install_scheduling": null,
"install_delay": null,
"postboot_delay": "10m"
}
Downloading wsusscn2.cab file from https://srvwapt.mydomain.lan/waptwua/wsusscn2.cab
wsusscn2.cab[================================] 1024297844/1024297844 - 00:02:04
Windows updates rules have been changed
Looking for updates with filter: Type='Software' or Type='Driver'
  Connecting to local update searcher using offline wsusscn2 file...
  Offline Update searcher ready...
Waiting for WUA search to complete
Done searching
WUA Search completed !
Updates scan done.
Writing status in local wapt DB
Status: OK
(0, 0, 0)
None
re-enabling wuauserv previous state: 0

4.5.2. wapt-get waptwua-download

La commande wapt-get waptwua-download analyse l’état de l’agent de mise à jour Windows par rapport aux règles actuelles, puis télécharge les kb manquants et enfin envoie le résultat au Serveur WAPT.

La commande wapt-get waptwua-download renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
Ensure wuauserv Auto Update option is disabled
Downloading wsusscn2.cab file from https://srvwapt.mydomain.lan/waptwua/wsusscn2.cab
wsusscn2.cab[================================] 1024297844/1024297844 - 00:00:26
Start of install for all pending Windows updates
Scanning with params:
{
"direct_download": false,
"default_allow": false,
"filter": "Type='Software' or Type='Driver'",
"download_scheduling": "7d",
"install_scheduling": null,
"install_delay": null,
"postboot_delay": "10m"
}
Scanning with windows updates rules:
{
"direct_download": false,
"default_allow": false,
"filter": "Type='Software' or Type='Driver'",
"download_scheduling": null,
"install_scheduling": null,
"install_delay": null,
"postboot_delay": "10m"
}
Bypassing scan, no change since last successful scan
Writing status in local wapt DB
Status: OK
{'downloaded': [], 'missing': []}
None
re-enabling wuauserv previous state: 0

4.5.3. wapt-get waptwua-install

La commande wapt-get waptwua-install installe les mises à jour Windows en attente sur la machine.

La commande wapt-get waptwua-install renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
Ensure wuauserv Auto Update option is disabled
Downloading wsusscn2.cab file from https://srvwapt.mydomain.lan/waptwua/wsusscn2.cab
wsusscn2.cab[================================] 1024297844/1024297844 - 00:00:26
Start of install for all pending Windows updates
Scanning with params:
{
"direct_download": false,
"default_allow": false,
"filter": "Type='Software' or Type='Driver'",
"download_scheduling": "7d",
"install_scheduling": null,
"install_delay": null,
"postboot_delay": "10m"
}
Scanning with windows updates rules:
{
"allowed_products": null,
"allowed_classifications": null,
"allowed_severities": null,
"allowed_updates": null,
"forbidden_updates": null,
"allowed_kbs": null,
"forbidden_kbs": null,
"default_allow": false
}
Looking for updates with filter: Type='Software' or Type='Driver'
  Connecting to local update searcher using offline wsusscn2 file...
  Offline Update searcher ready...
Waiting for WUA search to complete
Done searching
WUA Search completed !
Updates scan done.
Installed 07609d43-d518-4e77-856e-d1b316d1b8a8 : MSXML 6.0 RTM Security Update (925673)
Installed bb49cc19-8847-4986-aa93-5e905421e55a : Security Update for Microsoft Visual C++ 2005 Service Pack 1 Redistributable Package (KB2538242)
Installed 729a0dcb-df9e-4d02-b603-ed1aee074428 : Security Update for Microsoft Visual C++ 2008 Service Pack 1 Redistributable Package (KB2538243)
Installed 719584bc-2208-4bc9-a650-d3d6347eb32e : Security Update for Microsoft Visual C++ 2010 Service Pack 1 Redistributable Package (KB2565063)
Installed a8761130-35b6-41ce-8b67-2d35bb2d0846 : 2021-02 Cumulative Update for .NET Framework 3.5 and 4.8 for Windows 10, version 20H2 for x64 (KB4601050)
Installed 30f75e5d-2c46-42be-aef6-97ae730452be : 2021-07 Cumulative Update for Windows 10 Version 20H2 for x64-based Systems (KB5004945)
Installed 6e88be6e-d470-4e7e-9f36-01479049aadb : 2021-08 Servicing Stack Update for Windows 10 Version 20H2 for x64-based Systems (KB5005260)
Installed a15155a4-1299-41ff-9a39-28a33ce7cadd : 2021-12 .NET Core 3.1.22 Security Update for x64 Client (KB5009193)
Installed 38db0ad6-27f8-4bf9-ab2a-cffc4d7bc390 : Windows Malicious Software Removal Tool x64 - v5.96 (KB890830)
Scanning with windows updates rules:
{
"direct_download": false,
"default_allow": false,
"filter": "Type='Software' or Type='Driver'",
"download_scheduling": "7d",
"install_scheduling": null,
"install_delay": null,
"postboot_delay": "10m"
}
Windows updates rules have been changed
Writing status in local wapt DB
Status: OK
[]
None
re-enabling wuauserv previous state: 2

4.5.4. wapt-get waptwua-status

La commande wapt-get waptwua-status renvoie l’état le plus récent de Windows Update pour la machine.

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
{'enabled': None,
'last_error': 'OperationalError: cannot rollback - no transaction is active',
'last_install_batch': [],
'last_install_date': None,
'last_install_reboot_required': None,
'last_install_result': None,
'last_scan_date': '2022-01-07T10:20:50.213644',
'last_scan_duration': 1490.500022649765,
'missing_downloads': [],
'rules_packages': [],
'status': 'SCANNING',
'wsusscn2cab_date': '2021-12-14T04:06:46'}
None

4.6. Utiliser la ligne de commande pour interagir avec les utilisateurs Fonctionnalité WAPT Enterprise uniquement

4.6.1. wapt-get propose-upgrade

La commande wapt-get propose-upgrade propose aux utilisateurs connectés de lancer les mises à jour en attente.

La commande wapt-get propose-upgrade renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
{'result': 1, 'summary': 'waptexit launched for 1 sessions'}

4.7. Utilisation des lignes de commande pour la configuration initiale

4.7.1. wapt-get create-keycert

La commande wapt-get create-keycert [<options>] crée une paire de clés RSA et un certificat X509.

Liste des options disponibles pour créer des certificats.

Option

Description

Valeur par défaut

--CommonName

Affiche le nom du certificat.

/

--CommonName64

Affiche le nom du certificat, encodé en base64 (si accents, espaces etc…).

/

--CodeSigning Fonctionnalité WAPT Enterprise uniquement

Définit si la paire certificat / clé sera autorisée à signer des paquets logiciels.

0

--CA Fonctionnalité WAPT Enterprise uniquement

Définit si le certificat / la paire de clés peut être utilisé(e) pour signer d’autres certificats (c’est-à-dire pour être autorisé(e) à se comporter comme une autorité de certification principale ou intermédiaire).

0

--ClientAuth

Définit une propriété (usage) du certificat.

1 pour un certificat non-CA

--PrivateKeyPassword

Définit le mot de passe pour déverrouiller la clé si --NoPrivateKeyPassword n’est pas utilisé.

Mot de passe généré aléatoirement

--PrivateKeyPassword64 si --PrivateKeyPassword n’est pas utilisé

Définit le mot de passe pour déverrouiller la clé, encodé en base64 (si accents, espaces etc…).

Mot de passe généré aléatoirement

--NoPrivateKeyPassword

Définit la clé privée comme n’étant pas protégée par un mot de passe si --PrivateKeyPassword ou --PrivateKeyPassword64 ne sont pas utilisés.

Vide

-F

Force l’écrasement du certificat existant.

/

--Country

Définit le nom du pays du titulaire du certificat à enregistrer dans le certificat.

/

--Locality

Définit le nom de la ville du titulaire du certificat à enregistrer dans le certificat.

/

--Organization

Définit le nom de l’organisation du titulaire du certificat à enregistrer dans le certificat.

/

--OrgUnit

Définit le nom de l’unité d’organisation (service) du titulaire du certificat à enregistrer dans le certificat.

/

--Email

Définit l’adresse e-mail du titulaire du certificat à enregistrer dans le certificat.

/

--CAKeyFilename

Définit le chemin vers la clé privée (.pem) d’une Autorité de Certification.

Paramètre default_ca_key_path dans waptconsole.ini

--CACertFilename

Définit le chemin vers le certificat public (.crt) d’une Autorité de Certification.

Paramètre default_ca_cert_path dans waptconsole.ini

--CAKeyPassword

Définit le mot de passe pour déverrouiller la clé d’une Autorité de Certification.

/

-NoCAKeyPassword

Définit la clé de l’Autorité de Certification comme n’étant pas protégée par un mot de passe.

/

--BaseDir

Définit le dossier dans lequel la clé privée et le certificat public seront déposés.

Répertoire personal_certificate_path dans waptconsole.ini

-EnrollNewCert

Copie le certificat dans waptssl

/

-SetAsDefaultPersonalCert

Définit le personal_certificate_path dans waptconsole.ini.

/

La commande wapt-get create-keycert renvoie :

Using config file C:\Users\Administrator\AppData\Local\waptconsole\waptconsole.ini
BaseDir: C:\private\
Common name of certificate to create: documentation
Private Key Filename: C:\private\documentation.pem
Certificate Filename: C:\private\documentation.crt
New private key password: QR.-DVp6MPGW

Avertissement

Si default_ca_key_path et default_ca_cert_path sont définis dans waptconsole.ini, alors vous devez placer le certificat CA au même endroit sinon cette erreur apparaît :

wapt-get create-keycert
Using config file C:\Users\tisadmin\AppData\Local\waptconsole\waptconsole.ini
BaseDir: C:\Users\tisadmin\private\
Common name of certificate to create: CRT
Exception at 00483595: Exception:
CA Certificate C:\Program Files (x86)\wapt\ssl does not exist.

4.7.2. wapt-get build-waptagent

La wapt-get build-waptagent [</ConfigFilename>] compile et télécharge un paquet waptagent.exe et un waptupgrade.exe en utilisant le paramètre /ConfigFilename pour spécifier le contenu du fichier de configuration wapt-get.ini des Agents WAPT.

Note

Par défaut, la commande utilise les éléments de configuration du fichier waptconsole.ini de la console WAPT.

La commande wapt-get build-waptagent renvoie :

Building customized waptagent.exe installer
......................................................................................
Built C:\Users\documentation\AppData\Local\Temp\wapt20220107T12203700000.tmp\waptupgrade\waptagent.exe
Private key Password for C:\Users\documentation\private\documentation.crt : ********
Building waptupgrade package
Waptserver https://srvwapt.mydomain.lan Admin User () :admin
Waptserver Password: ************
Uploading customized waptagent.exe installer
Uploading C:\Users\documentation\AppData\Local\Temp\wapt20220107T12203700000.tmp\waptupgrade\waptagent.exe to waptserver https://srvwapt.mydomain.lan
OK
Uploading C:\Users\documentation\AppData\Local\Temp\wapt20220107T12203700000.tmp\tis-waptupgrade_2.1.2.10605-0_all_PROD_all.wapt to waptserver https://srvwapt.mydomain.lan
OK : 1 Packages uploaded, 0 errors. Errors:

4.8. Utilisation de lignes de commande spéciales avec WAPT

Option

Définition

--version

Affiche le numéro de version de WAPT et quitte.

-h | --help

Affiche ce message d’aide et quitte.

-c CONFIG | --config=CONFIG

Définit le chemin d’un autre fichier comme wapt-get.ini ou waptconsole.ini. Remplace le fichier normalement utilisé par la ligne de commande.

-l LOGLEVEL | --loglevel=LOGLEVEL

Définit le niveau des fichiers journaux en suivant cette liste : debug, warning, info, error, critical (défaut : warning).

-D | --direct

Indique de ne pas utiliser le service http pour update / upgrade.

-S | --service

Demande un utilisateur du Waptservice.

-u | --update-packages

Exécute wapt-get update avant la commande spécifiée.

-f | --force

Force la commande.

-p PARAMS | --params=PARAMS

Configure les paramètres comme un objet JSon.

-r WAPT_URL | -repo WAPT_URL | --repository=WAPT_URL

Remplace l’URL du dépôt WAPT principal tel que défini dans le fichier wapt-get.ini ou dans le fichier waptconsole.ini.

-y | --hide

Masque la Console WAPT pendant l’exécution de la commande.

-F FILTER_ON_HOST_CAP | --use-host-caps=FILTER_ON_HOST_CAP

Filtre les paquets en fonction des capacités actuelles de la machine (0/1).

-i | --inc-release

Incrémente le numéro de version de la version lors de la construction d’un paquet WAPT.

-a UPDATE_SERVER_STATUS | --update-server-status=UPDATE_SERVER_STATUS

Envoie le statut mis à jour de la machine (soft, paquets, etc.) au Serveur WAPT après l’action. UPDATE_SERVER_STATUS prend une valeur de True ou False.

keep-signature-date

Conserve la date de signature du paquet actuel, et la date de modification du fichier. A utiliser uniquement avec wapt-get sign-package.

-s SECTION_FILTER | --sections=SECTION_FILTER

Ajoute un filtre section à wapt-get search. La section est le type de paquet.

-o REDIRECT_OUTPUT | --output=REDIRECT_OUTPUT

Redirige la sortie vers un fichier .ini dont le chemin est défini par REDIRECT_OUTPUT.

-j | -json

Bascule sur une sortie formatée en json dans le but de réaliser des scripts d’automatisation.

-e ENCODING | --encoding=ENCODING

Change l’encodage des caractères pour la sortie.

-x EXCLUDES | --excludes=EXCLUDES

Définit une liste de fichiers ou de répertoires séparés par des virgules à exclure lors de la construction d’un paquet.

-k PERSONAL_CERTIFICATE_PATH | --certificate=PERSONAL_CERTIFICATE_PATH

Définit le chemin vers le certificat PEM X509 pour signer les paquets WAPT. Les paquets ne sont pas signés si le paramètre n’est pas fourni.

-w PRIVATE_KEY_PASSWD | --private-key-passwd=PRIVATE_KEY_PASSWD

Définit le chemin d’accès au fichier contenant le mot de passe de la clé privée.

-U USER | --user=USER

Définit un utilisateur interactif.

-g USERGROUPS | --usergroups=USERGROUPS

Définit les groupes de l’utilisateur final comme un tableau formaté en json pour la vérification des autorisations d’installation.

-t MAX_TTL | --maxttl=MAX_TTL

Définit la durée maximale d’exécution en minutes du processus wapt-get avant d’être tué par tout wapt-get ultérieur (défaut : 60 minutes).

-L LANGUAGE | --language=LANGUAGE

Remplace la locale pour l’installation des paquets WAPT, exemple : fr (défaut : en).

-m MD | --message-digest=MD

Définit le type de résumé de message pour wapt-get sign-package.

-n | --newest-only

Renvoie uniquement la version la plus récente des paquets WAPT lorsque vous utilisez wapt-get search.

--locales=LOCALES

Remplace le filtre local des paquets lorsque vous utilisez wapt-get search.

--maturity=MATURITY

Définit / modifie la maturité du paquet lors de la construction d’un paquet WAPT.

--pin-server-cert

Épingle le certificat du serveur lors de l’enregistrement de l’Agent WAPT.

--wapt-server-url=SET_WAPTSERVER_URL

Définit l’url du Serveur WAPT lorsque le paramètre wapt_server n’est pas défini dans le fichier de configuration wapt-get.ini de l’Agent WAPT.

--wapt-repo-url=SET_WAPTREPO_URL

Définit l’url du dépôt WAPT lorsque le paramètre repo_url n’est pas défini dans le fichier de configuration wapt-get.ini de l’Agent WAPT.

--wapt-server-user=WAPT_SERVER_USER

Définit l’utilisateur autorisé à télécharger des paquets vers le Serveur WAPT.

--wapt-server-passwd=WAPT_SERVER_PASSWD

Définit le mot de passe de l’utilisateur autorisé à télécharger des paquets vers le Serveur WAPT.

--log-to-windows-events

Enregistre les étapes dans le journal des événements de Windows.

--use-gui

Force l’utilisation de GUI Helper même si elle n’est pas en mode développement.

--no-ide

Indique à WAPT de ne pas lancer l”IDE lors de l’édition d’un paquet WAPT.