Skip to main content

Anleitung zur Installation der Alteryx One-App über die Befehlszeile

Enterprise Deployment

For IT-managed deployments, a complete Alteryx One installation requires two separate installers:

  1. Alteryx One app installer: Deploy first. The Alteryx One app is the required entry point for launching Designer 2026.1 and later. Use the command-line flags mentioned in this guide to deploy silently across machines.

  2. Designer installer: Deploy second. Download the Designer installer from the Download & Activate page in the Alteryx One app (or browser version). Use the Designer installer to script the full Designer installation, including optional components like Predictive Tools. For more details, go to Download and Install Desktop Modules.

Anmerkung

The command-line flags mentioned in this guide apply only to the Alteryx One app installer. The Designer installer has its own installation options.

Alteryx One App Installer

The Alteryx One installer supports command-line options that enable silent installations, enterprise deployments, and automated software distribution. This guide explains the available options, deployment considerations, and installer exit codes.

Anmerkung

Bei allen Flags des Installationsprogramms in der Befehlszeile wird zwischen Groß- und Kleinschreibung unterschieden. Ungültige Flags, falsche Rechtschreibung oder falsche Großschreibung werden ignoriert und führen nicht zu einer Fehlermeldung.

  • Standardinstallation (benutzerspezifisch): Wenn in der Befehlszeile keine Flags angegeben werden, führt das Installationsprogramm eine benutzerspezifische Installation im Standardspeicherort durch: %LOCALAPPDATA%\Alteryx\AlteryxOne

    Beispiel: AlteryxOne-1.0.352-US-setup.exe

  • /ALLUSERS: Verwenden Sie dieses Flag, um die Alteryx One-App für alle Benutzer:innen auf dem Rechner zu installieren (rechnerspezifische Installation).

    • Der Standardspeicherort der Installation ist C:\Program Files\Alteryx\AlteryxOne

    • Beispiel: AlteryxOne-1.0.352-US-setup.exe /ALLUSERS

  • /S: Verwenden Sie dieses Flag, damit das Installationsprogramm im Hintergrund ausgeführt wird. Bei diesem Flag wird das interaktive Installationsprogramm nicht angezeigt und alle Standardeinstellungen werden akzeptiert (falls nicht durch zusätzliche unterstützte Flags geändert). Beispiele:

    • AlteryxOne-1.0.352-US-setup.exe /S

    • AlteryxOne-1.0.352-US-setup.exe /S /ALLUSERS

  • /NOAUTOLAUNCH: Mit diesem Flag verhindern Sie, dass die Alteryx One-App nach der Installation automatisch gestartet wird. Diese Option wird nur für alle im Hintergrund durchgeführten Installationen (/S) unterstützt.

    Beispiele:

    • AlteryxOne-1.0.352-US-setup.exe /S /NOAUTOLAUNCH

    • AlteryxOne-1.0.352-US-setup.exe /S /ALLUSERS /NOAUTOLAUNCH

  • /D=<path>: Verwenden Sie dieses Flag, um ein benutzerdefiniertes Installationsverzeichnis anzugeben.

    Anforderungen und Einschränkungen:

    • Wird nur für im Hintergrund durchgeführte, rechnerspezifische Installationen unterstützt.

    • Unterstützt nur Installationen pro Rechner, benutzerdefinierte Speicherorte für Installationen pro Benutzer:in werden nicht unterstützt.

    • Das Installationsprogramm hängt automatisch einen Unterordner „AlteryxOne“ an den angegebenen Speicherort an.

      • /D=C:\temp\Alteryx führt zu einer Installation unter C:\temp\Alteryx\AlteryxOne.

      • /D=C:\temp\AlteryxOne führt zu einer Installation unter C:\temp\AlteryxOne\AlteryxOne.

        • Beispiel: AlteryxOne-1.0.352-US-setup.exe /S /ALLUSERS /D=C:\path\to\Installationsverzeichnis

          Installiert unter: C:\Installationsverzeichnis\AlteryxOne

        • Beispiel mit Leerzeichen: AlteryxOne-1.0.352-US-setup.exe /S /ALLUSERS /D=C:\Programme\Benutzerdefinierter Speicherort

          Führt zu einer Installation unter: C:\Programme\Benutzerdefinierter Speicherort\AlteryxOne

    Wichtige Überlegungen für das Flag /D=:

    • Der Parameter /D=<path> muss das letzte Argument in dem Befehl sein. Jeder Text, der nach /D= angezeigt wird, wird als Teil des Installationspfads und nicht als zusätzliche Installationsparameter interpretiert.

      Beispiel: Der Befehl AlteryxOne-1.0.359-US-setup.exe /ALLUSERS /D=C:\temp\Alteryx /S /NOAUTOLAUNCH führt zu einer Installation unter C:\temp\Alteryx S NOAUTOLAUNCH.

      Um unerwartete Installationsorte zu vermeiden, legen Sie /D= immer als letztes Argument fest: AlteryxOne-1.0.359-US-setup.exe /S /ALLUSERS /NOAUTOLAUNCH /D=C:\temp\Alteryx.

    • Setzen Sie den mit /D= angegebenen Pfad nicht in Anführungszeichen. Wenn Anführungszeichen verwendet werden, ignoriert das Installationsprogramm den Parameter /D= und führt die Installation im Standardordner für den ausgewählten Installationstyp durch.

      Beispiel: AlteryxOne-1.0.359-US-setup.exe /ALLUSERS /D="C:\temp\Alteryx"

      Ergebnis: Der Parameter /D= wird ignoriert und die Anwendung wird in folgendem Verzeichnis installiert: C:\Program Files\Alteryx\AlteryxOne

Anmerkung

Nicht unterstützte oder falsch kombinierte Flags geben keine Fehlermeldung zurück. Je nach Flag wird das Installationsprogramm die nicht unterstützte Option ignorieren oder den Befehl anders als erwartet interpretieren. Stellen Sie bei benutzerdefinierten Installationspfaden immer sicher, dass /D= das letzte Argument ist. Setzen Sie außerdem den mit /D= angegebenen Pfad nicht in Anführungszeichen.

Erfassen von Fehlercodes bei der im Hintergrund ausgeführten Installation von Alteryx One

Automatische Installationen liefern Exit-Codes zurück, die IT-Administrator:innen verwenden können, um zu überprüfen, ob die Installation erfolgreich abgeschlossen wurde oder fehlgeschlagen ist.

Dies gilt sowohl für benutzerspezifische als auch rechnerspezifische Installationen, die im Hintergrund ausgeführt werden. Bei interaktiven Installationen werden diese Fehler in Dialogmeldungen auf dem Bildschirm angezeigt.

Option A: Verwenden der Windows-Eingabeaufforderung

Verwenden Sie in der Windows-Eingabeaufforderung start /wait, damit das Terminal geöffnet bleibt, bis das Installationsprogramm abgeschlossen ist. Dann können Sie mit %ERRORLEVEL% den Exit-Code des Installationsprogramms anzeigen.

Beispiel: start /wait "" "AlteryxOne-1.0.359-US-setup.exe" /S /ALLUSERS echo Installer Exit Code: %ERRORLEVEL%

Option B: PowerShell verwenden

Wenn Sie in PowerShell den Start-Prozess mit den Parametern -Wait und -PassThru verwenden, können Sie den Abschluss der Installation abwarten und den Exit-Code erfassen.

Beispiel:

$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 mit Exit-Code $exitCode fehlgeschlagen" }

Exit-Code für das Alteryx One-Installationsprogramm

Exit-Code

Klassifizierung

Bedeutung und Ursache

Aktion erforderlich

0

Erfolg

Die Installation oder Deinstallation wurde erfolgreich abgeschlossen.

Keine

1

Abbruch durch Benutzer:in

Die Installation wurde manuell durch den/die Benutzer:in abgebrochen, der/die auf der Benutzeroberfläche auf Abbrechen geklickt hat.

Starten Sie die Installation erneut.

2

Wird bereits ausgeführt

Eine andere Instanz des Installationsprogramms von Alteryx One bereits ausgeführt.

Schließen Sie alle anderen Setup-Instanzen, bevor Sie es erneut versuchen.

3

Architektur stimmt nicht überein

Das Betriebssystem ist nicht 64-Bit Windows.

Führen Sie die Installation auf einem 64-Bit-Windows-Betriebssystem aus.

4

Konflikt bei der Installation

Es wurde ein Konflikt zwischen den Installationsmodi festgestellt. Beispiel: Eine rechnerspezifische Installation, während bereits eine benutzerspezifische Instanz existiert, oder umgekehrt.

Deinstallieren Sie den konfliktauslösenden Installationsmodus vollständig, bevor Sie fortfahren.

5

Gesperrte Dateien / aktive Prozesse

Einer der zentralen Anwendungsprozesse ist derzeit aktiv: AlteryxOne.exe oder update-helper.exe.

Schließen Sie Alteryx One und stoppen Sie den Aktualisierungsdienst. Führen Sie dann das Installationsprogramm erneut aus.

6

Erhöhen der Berechtigungen erforderlich

Für den Installationsmodus sind Administratorrechte erforderlich, der/die aktuelle Benutzer:in bzw. die aktuelle Shell verfügt aber nicht über erhöhte Berechtigungen. Dies gilt üblicherweise für rechnerspezifische Installationen des Typs /ALLUSERS.

Führen Sie die Eingabeaufforderung, PowerShell oder das Bereitstellungsskript als Administrator:in aus.

Anmerkung

Bei mit /S im Hintergrund durchgeführten Bereitstellungen überwachen Sie die Exit-Codes 4, 5 und 6. Hierbei handelt es sich um gängige Fehlerszenarien für die automatisierte Bereitstellung, zum Beispiel das Anstoßen einer rechnerspezifischen Installation, während noch eine benutzerspezifische Instanz vorhanden ist, oder das Ausführen des Installationsprogramms, während Alteryx One aktiv ist.

In diesem Abschnitt: