Software installieren oder aktualisieren

Wie du mit dieser Aktion ein Paket installierst oder alle veralteten Pakete aktualisierst, welche Einstellungen es gibt und wann der Schritt fehlschlägt.

Mit dieser Aktion installierst du ein Paket oder bringst es auf die gewünschte Version. Alternativ aktualisiert sie alle Pakete, die ein Paketmanager als veraltet meldet. Das Gerät muss dafür online sein.

Voraussetzungen

Das Gerät muss zum Paketmanager passen: winget oder Chocolatey unter Windows, APT unter Debian oder Ubuntu, Homebrew unter macOS. Eigene Pakete funktionieren nur unter Windows und brauchen eine veröffentlichte Version unter Konfiguration → Eigene Pakete.
Fehlt Chocolatey auf einem Windows-Gerät, installiert octoja es vor dem ersten Chocolatey-Paket. Was Homebrew auf Macs braucht, steht in der So funktioniert die Software-Bereitstellung.
Für Angemeldeter Benutzer unter Ausführen als muss jemand am Gerät angemeldet sein, wenn winget, Chocolatey oder ein eigenes Paket läuft.

Konfigurationsfelder

Das Eigenschaften-Panel hat zwei Felder:

Feld	Typ	Pflicht	Standard	Beschreibung
Software	Paketauswahl	Ja	—	Software suchen… öffnet den Dialog Software hinzufügen. Danach zeigt das Feld den Paketnamen (oder Alle veralteten aktualisieren), den Paketmanager und die Version (`latest`, wenn keine Version festgelegt ist). Ändern öffnet den Dialog mit den gespeicherten Werten. Ausnahme: Bei eigenen Paketen wählst du Version und Parameter erneut
Ausführen als	Auswahl	Nein	System (Agent-Identität)	System (Agent-Identität) installiert für alle Benutzer und funktioniert auch ohne angemeldeten Benutzer. Angemeldeter Benutzer führt den Paketmanager in dessen Sitzung aus. Das Feld gilt für winget, Chocolatey und eigene Pakete. APT läuft immer als `root`, Homebrew unter dem Konto, dem die Homebrew-Installation gehört

Im Dialog Software hinzufügen wählst du zuerst den Modus:

Modus	Wirkung
Einzelnes Paket (Standard)	Installiert das Paket, wenn es fehlt, und aktualisiert es auf die gewählte Version, wenn es veraltet ist. Eine Option „nur aktualisieren“ gibt es nicht.
Alle veralteten aktualisieren	Aktualisiert alle Pakete, die der Paketmanager als veraltet meldet. Paketname und Version brauchst du hier nicht. Eigene Pakete stehen in diesem Modus nicht zur Wahl.

Dann richtest du das Paket ein und bestätigst mit Zum Paket hinzufügen:

Feld	Modus	Details
Paketmanager	Beide	Registerkarten Chocolatey (vorausgewählt), Homebrew, winget, APT und Eigene.
Paketsuche	Einzelnes Paket	Bei Chocolatey, Homebrew und winget tippst du mindestens 2 Zeichen und wählst einen Treffer. Homebrew-Casks (grafische Apps) tragen das Kennzeichen Cask.
Paketname	Einzelnes Paket, APT	APT hat keine Suche. Gib den exakten Paketnamen wie bei `apt-get` ein, zum Beispiel `nginx`.
Version	Einzelnes Paket	Neueste (Standard) oder eine bestimmte Version aus der Liste. Bei APT tippst du eine exakte Version ein oder lässt das Feld leer. Homebrew installiert immer die aktuelle Version.
Eigenes Paket	Einzelnes Paket, Eigene	Wähle eines deiner veröffentlichten eigenen Pakete, dann die neueste veröffentlichte oder eine feste Version, und fülle die Parameter aus. Unter welchem Konto es läuft, bestimmt Ausführen als im Schritt.
Diese Pakete nie aktualisieren	Alle veralteten aktualisieren	Nur winget, Chocolatey und APT. Exakte Paket-IDs, Groß-/Kleinschreibung egal: zum Beispiel `Mozilla.Firefox` (winget), `firefox` (Chocolatey) oder ein Name aus `apt list --upgradable` (APT). Drücke nach jedem Eintrag Enter.
Mindestalter für Updates (Tage)	Alle veralteten aktualisieren	Nur winget und Chocolatey. 0–365, Standard `0` (keine Verzögerung). Versionen, die noch nicht so viele Tage verfügbar sind, werden übersprungen.

Wie das Mindestalter gemessen wird, erfährst du unter Software auf Geräte verteilen.

Plattformunterstützung

Plattform	Unterstützt
Windows	Ja — winget, Chocolatey, eigene Pakete
Linux	Ja — APT unter Debian und Ubuntu
macOS	Ja — Homebrew

Ausgaben

Ausgabe	Beschreibung
`success`	`true`, wenn der Schritt erfolgreich war, sonst `false`
`action`	Was passiert ist: `Installed`, `Updated`, `AlreadyUpToDate`, `Skipped` oder `Failed`
`installedVersion`	Version nach dem Schritt. Im Modus Alle veralteten aktualisieren leer
`previousVersion`	Version vor dem Schritt. Leer, wenn das Paket nicht installiert war, und im Modus Alle veralteten aktualisieren

Unter Variable einfügen heißen diese Ausgaben Erfolgreich, Aktion, Installierte Version und Vorherige Version.

Bei eigenen Paketen erkennt octoja nicht, welche Version vorher installiert war. Ein erfolgreicher Lauf meldet deshalb immer action = Installed, die feste oder neueste veröffentlichte Version als installedVersion und ein leeres previousVersion. Das gilt auch, wenn das Paket schon installiert war.

Ergebnisverhalten

Einzelnes Paket:

Fall	Ergebnis
Paket nicht installiert	Erfolgreich, `action` = `Installed`.
Ältere Version installiert	Erfolgreich, `action` = `Updated`.
Gewählte Version schon installiert, oder Neueste und keine neuere Version vorhanden	Erfolgreich, `action` = `AlreadyUpToDate`.
Paketmanager meldet einen Fehler	Fehlgeschlagen, `action` = `Failed`.
Version unverändert, obwohl noch ein Update verfügbar ist	Fehlgeschlagen. Vielleicht lief die Anwendung gerade, oder das Paket lässt sich mit der gewählten Einstellung unter Ausführen als nicht aktualisieren.
Paket nach dem Lauf nicht mehr erkannt	Fehlgeschlagen.
Paketmanager passt nicht zur Plattform, etwa Chocolatey auf einem Mac	Erfolgreich, `action` = `Skipped`. Es wird nichts installiert.
Version des eigenen Pakets nicht gefunden oder nicht veröffentlicht	Fehlgeschlagen.

Die Fälle zu Updates und zur Erkennung gelten nicht für eigene Pakete. Willst du in einer gemischten Geräteflotte nur die passenden Schritte laufen lassen, nutze eine Bedingung.

Alle veralteten aktualisieren:

Fall	Ergebnis
Nichts veraltet	Erfolgreich, `action` = `AlreadyUpToDate`.
Mindestens ein Paket aktualisiert	Erfolgreich, `action` = `Updated`.
Einzelne Pakete ließen sich nicht aktualisieren	Trotzdem Erfolgreich. Nur ein Fehler des Paketmanager-Befehls selbst lässt den Schritt fehlschlagen.
Ausgeschlossene Pakete	Werden nicht aktualisiert. Bereits installierte Versionen bleiben, wie sie sind.

In beiden Modi:

Fall	Ergebnis
Angemeldeter Benutzer, aber niemand angemeldet	Bei winget, Chocolatey und eigenen Paketen Fehlgeschlagen. APT und Homebrew laufen trotzdem.
Gerät beim Start des Schritts offline	Gerät offline. Je nach Wenn Gerät offline endet der Lauf mit diesem Status oder der Schritt wird übersprungen.
Keine Antwort vom Gerät innerhalb von fünf Minuten	Zeitüberschreitung.

Mit der Standardeinstellung unter Bei Fehler stoppt ein fehlgeschlagener Schritt den Workflow. Sollen spätere Schritte trotzdem laufen, wähle Mit nächstem Schritt fortfahren.

Schritt testen und Testlauf installieren und aktualisieren wirklich Software. Probiere einen neuen Schritt zuerst auf einem geeigneten Gerät aus.

FAQ

Wo sehe ich, welche Programme der Lauf aktualisiert hat?

Der Schritt zeigt die Programme nicht einzeln: Im Ausführungsverlauf meldet er nur, wie viele Pakete aktualisiert wurden. Eine Liste der einzelnen Pakete gibt es für diese Aktion nicht. Die Einträge mit der Quelle Deployment unter Aktivitäten → Protokoll eines Geräts stammen nur aus Software-Deployments in Konfigurationspaketen, nicht aus Automatisierungsschritten. Ein Automatisierungslauf hinterlässt dort nur einen Eintrag mit der Quelle Aufgabe zum Gesamtstatus des Laufs. Inventar → Software zeigt den aktuellen Softwarebestand, aber nicht, welcher Lauf eine Version installiert hat.

Siehe auch: Eine Automatisierung erstellen · Software auf Geräte verteilen · So funktioniert die Software-Bereitstellung · Eigene Pakete erstellen und verteilen

War dies hilfreich?

Brauchen Sie noch Hilfe? Team fragen