Guide d'installation en ligne de commande de l'application Alteryx One
Le programme d'installation Alteryx One prend en charge des options en ligne de commande qui permettent d'effectuer des installations silencieuses, des déploiements d'entreprise et une distribution automatisée des logiciels. Ce guide explique les options disponibles, les aspects à prendre en compte lors du déploiement et les codes de sortie du programme d'installation.
Note
Tous les indicateurs de ligne de commande du programme d'installation sont sensibles à la casse. Les indicateurs non valides, les fautes d'orthographe ou les erreurs de majuscules sont ignorés et ne génèrent pas de message d'erreur.
Installation par défaut (par utilisateur) : si aucun indicateur de ligne de commande n'est spécifié, le programme d'installation effectue une installation par utilisateur dans l'emplacement par défaut :
%LOCALAPPDATA%\Alteryx\AlteryxOneExemple :
AlteryxOne-1.0.352-US-setup.exe/ALLUSERS: utilisez cet indicateur pour installer l'application Alteryx One pour tous les utilisateurs de l'ordinateur (installation par ordinateur).Emplacement d'installation défaut :
C:\Program Files\Alteryx\AlteryxOneExemple :
AlteryxOne-1.0.352-US-setup.exe /ALLUSERS
/S: utilisez cet indicateur pour exécuter le programme d'installation en mode silencieux. Lors de son utilisation, le programme d'installation n'affiche pas l'interface interactive et accepte tous les paramètres par défaut, sauf s'ils sont modifiés par des indicateurs supplémentaires pris en charge. Exemples :AlteryxOne-1.0.352-US-setup.exe /SAlteryxOne-1.0.352-US-setup.exe /S /ALLUSERS
/NOAUTOLAUNCH: utilisez cet indicateur pour empêcher l'application Alteryx One de se lancer automatiquement après son installation. Cette option est prise en charge uniquement pour les installations silencieuses (/S).Exemples :
AlteryxOne-1.0.352-US-setup.exe /S /NOAUTOLAUNCHAlteryxOne-1.0.352-US-setup.exe /S /ALLUSERS /NOAUTOLAUNCH
/D=<path>: utilisez cet indicateur pour spécifier un répertoire d'installation personnalisé.Exigences et restrictions :
Prise en charge uniquement pour les installations silencieuses par ordinateur.
Ne prend en charge que les installations par ordinateur ; les emplacements personnalisés pour les installations par utilisateur ne sont pas pris en charge.
Le programme d'installation ajoute automatiquement un sous-dossier « AlteryxOne » à l'emplacement spécifié.
/D=C:\temp\Alteryxest installé à l'emplacementC:\temp\Alteryx\AlteryxOne./D=C:\temp\AlteryxOneest installé à l'emplacementC:\temp\AlteryxOne\AlteryxOne.Exemple :
AlteryxOne-1.0.352-US-setup.exe /S /ALLUSERS /D=C:\path\to\installLocationInstallation dans :
C:\InstallLocation\AlteryxOneExemple avec des espaces :
AlteryxOne-1.0.352-US-setup.exe /S /ALLUSERS /D=C:\Program Files\CustomLocationInstallation dans :
C:\Program Files\CustomLocation\AlteryxOne
Considérations importantes concernant l'indicateur
/D=:Le paramètre
/D=<path>doit être le dernier argument de la commande. Tout texte qui suit/D=est interprété comme faisant partie du chemin d'installation, et non comme des indicateurs supplémentaires du programme d'installation.Par exemple, la commande
AlteryxOne-1.0.359-US-setup.exe /ALLUSERS /D=C:\temp\Alteryx /S /NOAUTOLAUNCHinstalle le logiciel à l'emplacementC:\temp\Alteryx S NOAUTOLAUNCH.Pour éviter toute installation dans des emplacements inattendus, assurez-vous de placer toujours
/D=en dernier argument :AlteryxOne-1.0.359-US-setup.exe /S /ALLUSERS /NOAUTOLAUNCH /D=C:\temp\Alteryx.Ne mettez pas le chemin spécifié avec
/D=entre guillemets. Si des guillemets sont utilisés, le programme d'installation ignore le paramètre/D=et installe le logiciel à l'emplacement par défaut correspondant au type d'installation sélectionné.Exemple :
AlteryxOne-1.0.359-US-setup.exe /ALLUSERS /D="C:\temp\Alteryx"Résultat : le paramètre
/D=est ignoré et l'application est installée à l'emplacementC:\Program Files\Alteryx\AlteryxOne
Note
Les indicateurs non pris en charge ou mal combinés n'entraînent pas l'affichage d'un message d'erreur. Selon l'indicateur utilisé, le programme d'installation peut ignorer l'option non prise en charge ou interpréter la commande de manière différente de celle attendue. Pour les chemins d'installation personnalisés, assurez-vous toujours que /D= soit le dernier argument. En outre, ne mettez pas le chemin spécifié avec /D= entre guillemets.
Capture des codes d'erreur lors de l'installation de Alteryx One en mode silencieux
Les installations silencieuses renvoient des codes de sortie que les administrateurs informatiques peuvent utiliser pour déterminer si l'installation a réussi ou échoué.
Cela s'applique à la fois aux installations silencieuses par utilisateur et aux installations silencieuses par ordinateur. Dans le cas d'installations interactives, ces erreurs s'affichent sous forme de messages dans une fenêtre de dialogue à l'écran.
Option A : utilisation de l'invite de commandes Windows
Dans l'invite de commandes Windows, utilisez start /wait pour garder le terminal ouvert jusqu'à la fin de l'installation. Utilisez ensuite %ERRORLEVEL% pour afficher le code de sortie du programme d'installation.
Exemple : start /wait "" "AlteryxOne-1.0.359-US-setup.exe" /S /ALLUSERS echo Installer Exit Code: %ERRORLEVEL%
Option B : utilisation de PowerShell
Dans PowerShell, utilisez Start-Process avec les paramètres -Wait et PassThru pour attendre la fin du programme d'installation et capturer le code de sortie.
Exemple :
$process = Start-Process -FilePath "AlteryxOne-1.0.359-US-setup.exe" ` -ArgumentList "/S", "/ALLUSERS" ` -Wait ` -PassThru
$exitCode = $process.ExitCode
Write-Host "Installer Exit Code: $exitCode"
if ($exitCode -ne 0) { throw "Installation failed with exit code $exitCode" }
Codes de sortie du programme d'installation de Alteryx One
Code de sortie | Classification | Signification et cause | Action requise |
|---|---|---|---|
0 | Succès | L'installation ou la désinstallation s'est terminée avec succès. | Aucune |
1 | Abandon par l'utilisateur | L'installation a été annulée manuellement par l'utilisateur en cliquant sur Annuler dans l'interface utilisateur. | Relancez l'installation. |
2 | Déjà en cours d'exécution | Une autre instance du programme d'installation de Alteryx One est déjà en cours d'exécution. | Fermez toutes les autres instances de configuration avant de réessayer. |
3 | Incompatibilité architecturale | Le système d'exploitation n'est pas une version 64 bits de Windows. | Installez ce logiciel sur un système d'exploitation Windows 64 bits compatible. |
4 | Conflit d'installation | Un conflit a été détecté entre des modes d'installation. Exemple : installation par ordinateur alors qu'une instance par utilisateur existe déjà, ou vice versa. | Désinstallez complètement le mode d'installation conflictuel avant de poursuivre. |
5 | Fichiers verrouillés/Processus en cours d'exécution | L'un des processus critiques de l'application est actuellement actif : | Fermez Alteryx One et arrêtez le service de mise à jour, puis relancez l'installation. |
6 | Élévation de droits requise | Le mode d'installation nécessite des droits d'administrateur, et l'utilisateur ou le shell actuel ne dispose pas des autorisations nécessaires. Cela s'applique généralement aux installations par ordinateur | Exécutez l'invite de commandes, PowerShell ou le script de déploiement en tant qu'administrateur. |
Note
Pour les installations silencieuses utilisant /S, surveillez les codes de sortie 4, 5 et 6. Voici des exemples courants d'échecs de déploiement automatisé, tels que le déploiement d'une installation par ordinateur alors qu'une instance par utilisateur existe encore, ou l'exécution du programme d'installation alors que Alteryx One est actif.