> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/unigetui/de/fur-it-teams/organization/devolutions-agent.md).

# Genehmigte Apps ohne Administratorrechte installieren

Erstellen Sie eine Paketrichtlinie mit dem Richtlinieneditor von Devolutions UniGetUI und lassen Sie Standardbenutzer die von Ihnen genehmigten Apps ohne Administratorrechte oder UAC-Aufforderungen in

Standardbenutzer können die meisten Installationsprogramme unter Windows nicht ausführen. Mit Devolutions Agent müssen sie das nicht: Devolutions UniGetUI übergibt den Vorgang an den Agent, der ihn anhand **Ihrer Richtlinie** prüft und mit den nötigen Rechten ausführt. Benutzer erhalten die Apps, die sie haben dürfen, und sonst nichts.

{% hint style="info" %}
Nur Windows. Erfordert Devolutions Agent mit seiner Funktion UniGetUI Package Broker.
{% endhint %}

## So funktioniert es

1. Ein Benutzer klickt in Devolutions UniGetUI auf ***Installieren***, ***Aktualisieren*** oder ***Deinstallieren***.
2. Statt eine UAC-Aufforderung zu zeigen, sendet Devolutions UniGetUI die Anforderung an den Paketbroker von Devolutions Agent.
3. Bevor sie gesendet wird, prüft Devolutions UniGetUI die Anforderung gegen das, was der Agent akzeptiert, zum Beispiel die Installationsoptionen, die Architektur und die Rechteerhöhung. Eine Anforderung, die der Agent ablehnen würde, wird nicht gesendet: Der Vorgang schlägt mit ***The package broker cannot accept this request*** und der Liste der zu ändernden Optionen fehl.
4. Der Agent prüft, dass die Anforderung von einem signierten, unveränderten Devolutions UniGetUI kommt, und vergleicht sie dann mit der von Ihnen festgelegten Paketrichtlinie: welche Apps, Quellen, Vorgänge und Versionen erlaubt sind.
5. Wenn die Richtlinie es erlaubt, führt der Agent den Vorgang aus und Devolutions UniGetUI zeigt Fortschritt und Ausgabe wie gewohnt. Andernfalls schlägt der Vorgang mit ***Operation denied by policy***, dem Grund, den Sie in der Regel geschrieben haben, und der Regel-ID fehl.

**Im Fehlerfall wird abgelehnt.** Wenn der Agent nicht installiert ist, nicht läuft oder nicht erreichbar ist, schlägt der Vorgang fehl. Devolutions UniGetUI fällt nie auf eine UAC-Aufforderung zurück. Und wenn ein Benutzer den Broker in Devolutions UniGetUI ausschaltet, ist er wieder bei UAC-Aufforderungen, die er ohne Administratoranmeldeinformationen nicht bestätigen kann, also gewinnt er nichts.

Vorgänge von WinGet, Chocolatey, Scoop, Windows PowerShell, PowerShell 7, pip, npm, Bun, Cargo, .NET Tool und vcpkg können über den Agent laufen. Apps, die Devolutions UniGetUI auf dem Computer nur erkennt (Quelle ***Lokaler PC***), werden nicht an ihn gesendet. Ein über den Broker laufender Vorgang, der nicht innerhalb einer Stunde endet, wird als fehlgeschlagen gemeldet, auch wenn er im Agent möglicherweise noch läuft.

## Den Broker einrichten

{% stepper %}
{% step %}

### Devolutions Agent mit dem Paketbroker installieren

Der Paketbroker ist die Funktion ***UniGetUI Package Broker*** des Installationsprogramms von Devolutions Agent. Sie ist standardmäßig aus.

1. Wählen Sie ***UniGetUI Package Broker*** im Installationsprogramm von Devolutions Agent oder fügen Sie bei einer stillen Installation `F.PackageBroker` zu `ADDLOCAL` hinzu. `ADDLOCAL` installiert nur die Funktionen, die es auflistet:

```powershell
msiexec /i DevolutionsAgent.msi /qn ADDLOCAL=F.Agent,F.Updater,F.Session,F.PackageBroker
```

2. Stellen Sie ihn auf den Computern bereit. Siehe [Devolutions Agent im Hintergrund bereitstellen](https://docs.devolutions.net/agent/de/deploy-devolutions-agent-silently).

Die Funktion setzt `PackageBroker.Enabled` in `%ProgramData%\Devolutions\Agent\agent.json` auf `true`. Der Agent liest seine Richtlinie aus `%ProgramData%\Devolutions\PackageBroker\package-broker-policy.json`, sofern `PackageBroker.PolicyPath` in `agent.json` nicht auf eine andere Datei zeigt. Solange keine gültige Richtlinie existiert, lehnt der Agent jeden Paketvorgang ab.
{% endstep %}

{% step %}

### Devolutions UniGetUI für alle Benutzer installieren

[Installieren Sie Devolutions UniGetUI für alle Benutzer](https://docs.devolutions.net/unigetui/de/fur-it-teams/organization/deploy.md) (`/ALLUSERS`), in `C:\Program Files\UniGetUI`. Der Agent akzeptiert nur Anforderungen von einem signierten Devolutions UniGetUI, das Standardbenutzer nicht ändern können, und das Erstellen oder Bearbeiten der Richtlinie aus Devolutions UniGetUI erfordert ebenfalls diese Installation.
{% endstep %}

{% step %}

### Den Broker in Devolutions UniGetUI aktivieren

1. Gehen Sie zu ***Einstellungen*** – ***Administratorrechte und andere riskante Einstellungen***.
2. Aktivieren Sie ***Paketvorgänge an den Devolutions Agent-Broker delegieren***.

Ab jetzt laufen Installation, Update und Deinstallation über den Agent. Solange keine gültige Paketrichtlinie installiert ist, schlagen sie mit ***Package operations are paused*** fehl.

Um es für Ihre Benutzer aus einem Skript einzuschalten, führen Sie `UniGetUI.exe --enable-setting UseAgentBroker` in der Sitzung jedes Benutzers aus. In der [Terminaloberfläche](https://github.com/Devolutions/RDM/tree/master/docs-products/translations/de/unigetui/reference/terminal-ui.md) heißt die Option ***Paketvorgänge an den Devolutions Agent delegieren***.
{% endstep %}
{% endstepper %}

## Die Paketrichtlinie erstellen und bearbeiten

Die Paketrichtlinie listet auf, was Benutzer installieren, aktualisieren und deinstallieren dürfen. Sie erstellen und ändern sie in Devolutions UniGetUI mit dem Richtlinieneditor des Paketbrokers.

1. Gehen Sie zu ***Einstellungen*** – ***Administratorrechte und andere riskante Einstellungen***.
2. Klicken Sie auf ***Inspect active package broker policy***.
3. Wenn ***State*** anzeigt, dass keine Richtliniendatei existiert, klicken Sie auf ***Create***. Um die aktive Richtlinie zu ändern, klicken Sie auf ***Edit***.
4. Ersetzen Sie die ***Policy ID*** (`new-policy` in einer neuen Richtlinie) durch Ihre eigene, zum Beispiel `contoso-workstations`.
5. Ersetzen Sie den ***Publisher*** (`Your organization`) durch den Namen Ihrer Organisation.
6. Geben Sie optional eine ***Support URL*** ein, unter der Benutzer eine Ausnahme anfragen können. Um eine Beschreibung hinzuzufügen, wählen Sie ***Description*** und geben Sie sie ein.
7. Erweitern Sie unter ***Enforcement*** den Eintrag ***Advanced*** und lassen Sie die ***Default decision*** auf ***Deny***, damit alles blockiert wird, was Sie nicht ausdrücklich erlauben.
8. Klicken Sie für jede Gruppe von Apps, die Sie erlauben möchten, auf ***Add rule***. Eine neue Regel ist eine deaktivierte ***Deny***-Regel.
9. Setzen Sie in jeder Regel ***Decision*** auf ***Allow*** und wählen Sie ihre Übereinstimmungskriterien.
10. Aktivieren Sie das Kontrollkästchen in der Regelkopfzeile, um die Regel zu aktivieren.
11. Klicken Sie auf ***Speichern*** und bestätigen Sie die Windows-Administratoraufforderung.

Die ***Policy ID*** kann beim Bearbeiten einer Richtlinie nicht geändert werden. Um mit einer anderen ID neu zu beginnen, klicken Sie auf ***Replace identity*** statt auf ***Edit***.

Um eine Regel später zu ändern, öffnen Sie den Editor mit ***Edit***. Jede Regel hat die Schaltflächen ***Duplicate***, ***Move up***, ***Move down*** und ***Delete***. Um die ganze Richtlinie als JSON zu prüfen oder zu ändern, klicken Sie oben im Editor auf ***Raw JSON*** und auf ***Structured***, um zu den geführten Feldern zurückzukehren.

{% hint style="info" %}
Erster Rollout? Setzen Sie unter ***Enforcement*** – ***Advanced*** ***Audit mode*** auf ***Ja***. Der Agent protokolliert, was er ablehnen würde, lässt aber alles durch. Wenn die Protokolle stimmen, setzen Sie ihn zurück auf ***Nein***.
{% endhint %}

Sie können die Richtliniendatei auch mit Ihrem üblichen Werkzeug bereitstellen, statt sie von jedem Computer aus zu speichern: Erstellen Sie sie einmal im Editor, kopieren Sie das Ergebnis aus dem Abschnitt ***Canonical policy JSON*** der Prüfseite und kopieren Sie die Datei dann in den Richtlinienpfad jedes Computers. Der Agent lädt die Datei neu, wenn sie sich ändert. Er akzeptiert nur eine Datei und einen Ordner, in die nur SYSTEM und die Gruppe Administrators schreiben können, und behandelt jede andere Datei als ungültig.

### Was eine Richtlinie steuern kann

Jede Regel ist auf ***Allow*** oder ***Deny*** gesetzt und gilt für die Anforderungen, die ihr entsprechen. Regeln werden der Reihe nach ausgewertet: Die erste aktivierte Regel, die passt, entscheidet, und ***Move up*** und ***Move down*** ändern die Reihenfolge. Wenn keine aktivierte Regel passt, gilt die ***Default decision***. Lassen Sie ein Kriterium leer, um alles zu treffen.

<table><thead><tr><th width="220">STEUERUNG</th><th>BEISPIELE</th></tr></thead><tbody><tr><td><strong>Paketbezeichner</strong></td><td>Genaue Bezeichner (<code>Mozilla.Firefox</code>) oder Bezeichnermuster mit <code>*</code> und <code>?</code> (<code>Contoso.*</code>).</td></tr><tr><td><strong>Quellennamen</strong></td><td>Nur die Quelle <code>winget</code> oder Ihr interner Chocolatey-Feed. Verfügbar, wenn genau ein Paketmanager ausgewählt ist, der Quellen unterstützt.</td></tr><tr><td><strong>Vorgänge</strong></td><td>Updates für alles erlauben, Installationen aber nur für eine kurze Liste.</td></tr><tr><td><strong>Paketversionen</strong></td><td>Genaue Versionen oder ein Bereich mit einer Mindest- und einer Höchstversion, mit oder ohne Vorabversionen. Versionskriterien gelten nicht für Deinstallationen.</td></tr><tr><td><strong>Bereiche, Architekturen, Ausführungsrecht</strong></td><td>Installationen für den Benutzer oder den Computer; Pakete für x86, x64, Arm64 oder neutral; Standardanforderungen oder Anforderungen mit erhöhten Rechten.</td></tr><tr><td><strong>Anforderungsmerkmale</strong></td><td>Interaktive Installationen, übersprungene Hash-Prüfungen, Vorabversionen, benutzerdefinierte Parameter, benutzerdefinierter Installationsort, Befehle davor/danach, Beenden laufender Apps, Deinstallieren der vorherigen Version. Jedes ist <em><strong>Spielt keine Rolle</strong></em>, <em><strong>Ja</strong></em> oder <em><strong>Nein</strong></em>.</td></tr></tbody></table>

Wenn ein Anforderungsdetail unbekannt ist, zum Beispiel eine Version, die der Paketmanager während der Installation wählt, passen Deny-Regeln auf die Anforderung und Allow-Regeln nicht.

Erweitern Sie bei einer ***Allow***-Regel ***Additional safety limits*** und wählen Sie ***Add safety limits to this Allow rule***, um einzuschränken, was eine passende Anforderung tun darf, zum Beispiel benutzerdefinierte Parameter zu verbieten oder nur einige Installationsordner zu akzeptieren.

{% hint style="danger" %}
Das Überspringen von Hash-Prüfungen, benutzerdefinierte Parameter und Befehle davor/danach können beliebigen Code mit erhöhten Rechten ausführen. Lassen Sie sie in Ihren Allow-Regeln aus, es sei denn, Sie haben einen konkreten Bedarf geprüft.
{% endhint %}

Sie können auch mit ***Valid from*** und ***Valid until*** begrenzen, wann die ganze Richtlinie gilt. Außerhalb dieses Zeitraums lehnt der Agent Paketvorgänge ab.

## Prüfen, ob es funktioniert

Installieren Sie von einem Standardbenutzerkonto eine erlaubte und eine verbotene App. Die erste sollte ohne Aufforderung installiert werden; die zweite sollte mit ***Operation denied by policy*** fehlschlagen.

## Die aktive Richtlinie prüfen

Jeder kann prüfen, was auf einem Computer erzwungen wird. Das hilft, wenn ein Benutzer eine abgelehnte App meldet.

1. Gehen Sie zu ***Einstellungen*** – ***Administratorrechte und andere riskante Einstellungen***.
2. Klicken Sie auf ***Inspect active package broker policy***.
3. Prüfen Sie den Abschnitt ***Package broker policy*** und dann die Regeln. Klicken Sie nach einer Richtlinienänderung auf ***Refresh***.

<table><thead><tr><th width="260">FELD</th><th>WAS ES IHNEN SAGT</th></tr></thead><tbody><tr><td><strong>State</strong></td><td>Ob eine gültige Richtlinie in Kraft, fehlend oder ungültig ist. Eine ungültige Richtlinie muss von einem Administrator außerhalb von Devolutions UniGetUI korrigiert oder ersetzt werden.</td></tr><tr><td><strong>Configured path</strong> / <strong>Path source</strong></td><td>Wo der Agent die Richtliniendatei liest und ob das sein Standardspeicherort oder ein in der Agent-Konfiguration gesetzter Pfad ist.</td></tr><tr><td><strong>Agent write capability</strong></td><td>Ob der Agent das Ändern der Richtlinie zulässt: <strong>Writable</strong>, <strong>Read-only</strong> oder <strong>Unsupported</strong>.</td></tr><tr><td><strong>Policy changes from this app</strong> / <strong>Reason</strong></td><td>Ob Sie die Richtlinie aus diesem Devolutions UniGetUI bearbeiten können, und warum nicht. Das Bearbeiten braucht die Erlaubnis des Agent und eine Installation für alle Benutzer.</td></tr><tr><td><strong>Elevation required</strong></td><td>Ob das Speichern die Bestätigung eines Windows-Administrators verlangt.</td></tr></tbody></table>

Unter den Regeln zeigt ***Canonical policy JSON*** die Richtlinie genau so, wie der Agent sie liest. Klicken Sie auf ***Copy to clipboard***, um sie zu kopieren, zum Beispiel um sie an den Support zu senden.

Wenn die Seite ***Devolutions Agent is unavailable*** anzeigt, prüfen Sie, dass der Agent installiert ist und sein Dienst läuft, und klicken Sie dann auf ***Refresh***.

## Was Benutzer sehen

Für Benutzer ändert sich nichts: Sie installieren und aktualisieren Apps wie gewohnt, ohne UAC-Aufforderungen. Wenn etwas schiefgeht, schlägt der Vorgang mit einer dieser Meldungen fehl:

<table><thead><tr><th width="280">MELDUNG</th><th>WAS ZU TUN IST</th></tr></thead><tbody><tr><td><strong>Operation denied by policy</strong></td><td>Die Richtlinie erlaubt diese App, Quelle, diesen Vorgang oder diese Version nicht. Der Grund und die ID der Regel werden angezeigt. Fragen Sie Ihren Administrator.</td></tr><tr><td><strong>The package broker cannot accept this request</strong></td><td>Devolutions UniGetUI hat die Anforderung nicht gesendet, weil der Agent einige ihrer Optionen ablehnen würde. Die Optionen sind aufgeführt. Ändern Sie die Installationsoptionen des Pakets oder wählen Sie ein anderes Paket oder eine andere Quelle.</td></tr><tr><td><strong>The package broker rejected the request</strong></td><td>Der Agent hat eine der Optionen des Vorgangs nicht akzeptiert. Die Details werden angezeigt. Ändern Sie die Installationsoptionen des Pakets.</td></tr><tr><td><strong>Package operations are paused</strong></td><td>Es ist keine gültige Paketrichtlinie installiert. Fragen Sie Ihren Administrator.</td></tr><tr><td><strong>The Devolutions Agent refused this operation</strong></td><td>Der Agent erlaubt den Vorgang gerade nicht, zum Beispiel weil die Richtlinie außerhalb ihres Zeitraums <em><strong>Valid from</strong></em> und <em><strong>Valid until</strong></em> liegt. Fragen Sie Ihren Administrator.</td></tr><tr><td><strong>UniGetUI is not authorized to use the Devolutions Agent</strong></td><td>Der Agent akzeptiert nur signierte, unveränderte Kopien von Devolutions UniGetUI. Installieren Sie eine offizielle Version für alle Benutzer.</td></tr><tr><td><strong>Administrator rights are required</strong></td><td>Der Agent akzeptiert diese Anforderung nur von einem Administrator, der mit erhöhten Rechten ausgeführt wird.</td></tr><tr><td><strong>Agent broker unavailable</strong></td><td>Devolutions Agent ist nicht installiert oder läuft nicht.</td></tr><tr><td><strong>The Devolutions Agent is busy</strong></td><td>Der Agent verarbeitet zu viele Anforderungen. Versuchen Sie es gleich noch einmal.</td></tr><tr><td><strong>The request is too large</strong></td><td>Die benutzerdefinierten Argumente oder Befehle des Vorgangs sind zu lang. Kürzen Sie sie.</td></tr><tr><td><strong>Operation unsupported by broker</strong></td><td>Der Agent unterstützt diesen Vorgang oder diese Option nicht.</td></tr><tr><td><strong>Broker communication error</strong></td><td>Der Agent hat nicht rechtzeitig geantwortet oder eine unerwartete Antwort zurückgegeben. Versuchen Sie es gleich noch einmal.</td></tr><tr><td><strong>The module conflicts with installed commands</strong></td><td>Ein Windows PowerShell-Modul braucht die Option <code>-AllowClobber</code>, die über den Agent nicht verwendet werden kann. Fragen Sie Ihren Administrator.</td></tr><tr><td><strong>Operation failed via broker</strong></td><td>Der Agent hat die Anforderung angenommen, aber der Vorgang ist fehlgeschlagen oder nicht rechtzeitig zu Ende gekommen. Öffnen Sie die Ausgabe des Vorgangs für Details.</td></tr></tbody></table>

## Wenn es nicht funktioniert

* Jeder Vorgang schlägt mit ***Agent broker unavailable*** fehl: Der Agent-Dienst ist beendet oder fehlt, oder seine Funktion ***UniGetUI Package Broker*** ist nicht installiert. Siehe [Ein Update oder eine Installation schlägt fehl](https://docs.devolutions.net/unigetui/de/hilfe/troubleshooting/update-or-install-fails.md).
* Jeder Vorgang schlägt mit ***UniGetUI is not authorized to use the Devolutions Agent*** fehl: Devolutions UniGetUI ist nur für den aktuellen Benutzer installiert, oder es ist keine offizielle Version. [Installieren Sie es für alle Benutzer neu](https://docs.devolutions.net/unigetui/de/fur-it-teams/organization/deploy.md).
* Sie können nicht auf ***Create*** oder ***Edit*** klicken: Lesen Sie das Feld ***Reason***. Meist ist Devolutions UniGetUI nicht für alle Benutzer installiert, oder der Agent erlaubt keine Richtlinienänderungen.
* Ein Benutzer braucht Unterstützung: [Protokolle an den Support senden](https://docs.devolutions.net/unigetui/de/hilfe/troubleshooting/send-logs-to-support.md).

## Als Nächstes

* [Riskante Einstellungen sperren](https://docs.devolutions.net/unigetui/de/fur-it-teams/organization/restrict-settings.md)
* [Arbeitsplätze vereinheitlichen](https://docs.devolutions.net/unigetui/de/fur-it-teams/organization/standard-workstations.md)
* [Dokumentation zu Devolutions Agent](https://docs.devolutions.net/agent/de/)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/unigetui/de/fur-it-teams/organization/devolutions-agent.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
