> 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/it/per-i-team-it/organization/devolutions-agent.md).

# Installare applicazioni approvate senza diritti di amministratore

Consenta agli utenti standard di installare e aggiornare le applicazioni che approva, senza diritti di amministratore né richieste UAC, delegando le operazioni a Devolutions Agent.

Gli utenti standard non possono eseguire la maggior parte dei programmi di installazione in Windows. Con Devolutions Agent, non ne hanno bisogno: UniGetUI affida l'operazione all'agente, che la controlla secondo **il suo criterio** e la esegue con i diritti necessari. Gli utenti ottengono le applicazioni che è consentito loro avere, e nient'altro.

{% hint style="info" %}
Solo Windows. Richiede Devolutions Agent.
{% endhint %}

## Come funziona

1. Un utente fa clic su ***Installa***, ***Aggiorna*** o ***Disinstalla*** in UniGetUI.
2. Invece di mostrare una richiesta UAC, UniGetUI invia la richiesta al broker dei pacchetti di Devolutions Agent.
3. L'agente confronta la richiesta con il criterio che ha definito: quali applicazioni, origini, operazioni e versioni sono consentite.
4. Se il criterio lo consente, l'agente esegue l'operazione e UniGetUI mostra l'avanzamento e l'output come di consueto. Altrimenti l'operazione non riesce con ***Operation denied by policy*** e il motivo che ha scritto nella regola.

**Se non risponde, viene negato.** Se l'agente non è installato, non è in esecuzione o non è raggiungibile, l'operazione non riesce. UniGetUI non torna mai a una richiesta UAC. E se un utente disattiva il broker in UniGetUI, torna a richieste UAC che non può approvare senza credenziali di amministratore, quindi non ottiene nulla.

Le operazioni di WinGet, Chocolatey, Scoop, Windows PowerShell, PowerShell 7, pip, npm, Bun, Cargo, .NET Tool e vcpkg possono passare dall'agente. Le applicazioni che UniGetUI si limita a rilevare sul computer (origine ***PC locale***) non gli vengono inviate.

{% stepper %}
{% step %}

### Installare e attivare il broker in Devolutions Agent

Installi Devolutions Agent sui computer. Veda [Distribuire Devolutions Agent in modo invisibile](https://docs.devolutions.net/resources/it/devolutions-agent/deploy-devolutions-agent-silently).

{% hint style="warning" %}
**Documentazione in arrivo.** I passaggi per attivare il broker dei pacchetti in Devolutions Agent, e per impostare dove l'agente legge il file dei criteri e se UniGetUI può modificarlo, non sono ancora documentati. Contatti il supporto Devolutions se le servono adesso.
{% endhint %}

Installi anche [UniGetUI per tutti gli utenti](/unigetui/it/per-i-team-it/organization/deploy.md) (`/ALLUSERS`). È necessario per creare o modificare il criterio da UniGetUI.
{% endstep %}

{% step %}

### Attivare il broker in UniGetUI

1. Vada in ***Impostazioni*** – ***Diritti di amministratore e altre impostazioni pericolose***.
2. Attivi ***Delega le operazioni sui pacchetti al broker Devolutions Agent***.

Da questo momento, le operazioni di installazione, aggiornamento e disinstallazione passano dall'agente.
{% endstep %}

{% step %}

### Creare il criterio

1. Nella stessa pagina delle impostazioni, faccia clic su ***Inspect active package broker policy***.
2. Se ***State*** indica che non esiste alcun criterio, faccia clic su ***Create***. Per modificare un criterio esistente, faccia clic su ***Edit***.
3. Immetta un ***Policy ID*** (per esempio `contoso-workstations`) e un ***Editore***. Se vuole, aggiunga una ***Description*** e una ***Support URL*** dove gli utenti possono chiedere un'eccezione.
4. Lasci ***Default decision*** su ***Deny***, così tutto ciò che non consente esplicitamente viene bloccato.
5. Faccia clic su ***Add rule*** per ogni gruppo di applicazioni che vuole consentire (veda più sotto).
6. Faccia clic su ***Salva*** e approvi la richiesta di amministratore di Windows.

{% hint style="info" %}
Prima distribuzione? Imposti ***Audit mode*** su ***Sì***. L'agente registra ciò che negherebbe, ma lascia passare tutto. Quando i registri sono corretti, lo riporti su ***No***.
{% endhint %}
{% endstep %}

{% step %}

### Verificare che funzioni

Installi un'applicazione consentita e una vietata da un account utente standard. La prima deve installarsi senza alcuna richiesta; la seconda deve non riuscire con ***Operation denied by policy***.
{% endstep %}
{% endstepper %}

## Che cosa può controllare un criterio

Ogni regola ***Allow*** o ***Deny*** le richieste che corrispondono. Le regole vengono valutate in ordine; usi ***Move up*** e ***Move down*** per cambiarlo. Lasci vuoto un criterio per far corrispondere tutto.

<table><thead><tr><th width="220">CONTROLLO</th><th>ESEMPI</th></tr></thead><tbody><tr><td><strong>Packages</strong></td><td>ID esatti (<code>Mozilla.Firefox</code>) o motivi (<code>Contoso.*</code>).</td></tr><tr><td><strong>Sorgenti</strong></td><td>Solo l'origine <code>winget</code>, o il feed Chocolatey interno. Disponibile quando è selezionato un solo gestore di pacchetti.</td></tr><tr><td><strong>Operazioni</strong></td><td>Consentire gli aggiornamenti per tutto, ma le installazioni solo per un breve elenco.</td></tr><tr><td><strong>Versions</strong></td><td>Versioni esatte, o un intervallo con una versione minima e una versione massima, con o senza versioni preliminari.</td></tr><tr><td><strong>Scope, architecture, privilege</strong></td><td>Installazioni per l'utente o per il computer; x86, x64, Arm64; richieste standard o elevate.</td></tr><tr><td><strong>Request options</strong></td><td>Installazioni interattive, controlli hash saltati, parametri personalizzati, posizione di installazione personalizzata, comandi prima/dopo e altro.</td></tr></tbody></table>

In una regola ***Allow***, selezioni ***Add safety limits to this Allow rule*** per limitare ciò che una richiesta corrispondente può fare, per esempio vietare parametri personalizzati o una posizione di installazione personalizzata.

{% hint style="danger" %}
Saltare i controlli hash, i parametri personalizzati e i comandi prima/dopo possono eseguire codice arbitrario con diritti elevati. Li lasci disattivati nelle regole Allow, a meno che non abbia esaminato un'esigenza specifica.
{% endhint %}

Può anche limitare quando si applica l'intero criterio con ***Valid from*** e ***Valid until***. Fuori da questo periodo, l'agente rifiuta le operazioni sui pacchetti.

## Ispezionare il criterio attivo

Chiunque può verificare che cosa è applicato su un computer, il che aiuta quando un utente segnala un'applicazione negata.

1. Vada in ***Impostazioni*** – ***Diritti di amministratore e altre impostazioni pericolose***.
2. Faccia clic su ***Inspect active package broker policy***.
3. Esamini la sezione ***Package broker policy***, poi le regole. Faccia clic su ***Refresh*** dopo una modifica del criterio.

<table><thead><tr><th width="260">CAMPO</th><th>CHE COSA LE DICE</th></tr></thead><tbody><tr><td><strong>State</strong></td><td>Se un criterio valido è in vigore, manca o non è valido. Un criterio non valido deve essere corretto o sostituito da un amministratore, al di fuori di UniGetUI.</td></tr><tr><td><strong>Configured path</strong> / <strong>Path source</strong></td><td>Dove l'agente legge il file dei criteri e se quella è la posizione predefinita.</td></tr><tr><td><strong>Agent write capability</strong></td><td>Se l'agente consente di modificare il criterio: <strong>Writable</strong>, <strong>Read-only</strong> o <strong>Unsupported</strong>.</td></tr><tr><td><strong>Policy changes from this app</strong> / <strong>Reason</strong></td><td>Se può modificare il criterio da questo UniGetUI, e perché no. La modifica richiede l'autorizzazione dell'agente e un'installazione per tutti gli utenti.</td></tr><tr><td><strong>Elevation required</strong></td><td>Se il salvataggio chiede l'approvazione di un amministratore di Windows.</td></tr></tbody></table>

Se la pagina mostra ***Devolutions Agent is unavailable***, verifichi che l'agente sia installato e che il suo servizio sia in esecuzione, poi faccia clic su ***Refresh***.

## Che cosa vedono gli utenti

Per gli utenti, niente cambia: installano e aggiornano le applicazioni come al solito, senza richieste UAC. Quando qualcosa va storto, l'operazione non riesce con uno di questi messaggi:

<table><thead><tr><th width="280">MESSAGGIO</th><th>CHE COSA FARE</th></tr></thead><tbody><tr><td><strong>Operation denied by policy</strong></td><td>Il criterio non consente questa applicazione, questa origine, questa operazione o questa versione. Viene mostrato il motivo della regola. Chieda al suo amministratore.</td></tr><tr><td><strong>Agent broker unavailable</strong></td><td>Devolutions Agent non è installato o non è in esecuzione.</td></tr><tr><td><strong>Operation unsupported by broker</strong></td><td>L'agente non supporta questa operazione o questa opzione.</td></tr><tr><td><strong>Broker communication error</strong></td><td>L'agente non ha risposto in tempo. L'operazione potrebbe essere ancora in corso.</td></tr><tr><td><strong>Operation failed via broker</strong></td><td>L'agente ha accettato la richiesta, ma l'installazione non è riuscita. Apra l'output dell'operazione per i dettagli.</td></tr></tbody></table>

## Se non funziona

* Ogni operazione non riesce con ***Agent broker unavailable***: il servizio dell'agente è arrestato o manca. Veda [Un aggiornamento o un'installazione non riesce](/unigetui/it/aiuto/troubleshooting/update-or-install-fails.md).
* Non può fare clic su ***Create*** o ***Edit***: legga il campo ***Reason***. Di solito UniGetUI non è installato per tutti gli utenti, oppure l'agente non consente le modifiche ai criteri.
* Un utente ha bisogno di assistenza: [Inviare i registri al supporto](/unigetui/it/aiuto/troubleshooting/send-logs-to-support.md).

## Passo successivo

* [Bloccare le impostazioni rischiose](/unigetui/it/per-i-team-it/organization/restrict-settings.md)
* [Standardizzare le postazioni di lavoro](/unigetui/it/per-i-team-it/organization/standard-workstations.md)
* [Documentazione di Devolutions Agent](https://docs.devolutions.net/resources/it/devolutions-agent)


---

# 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/it/per-i-team-it/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.