> 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/cli/it/per-devops-e-amministratori/manage/users-and-access.md).

# Gestire utenti, gruppi e accesso

Gestire utenti, gruppi, ruoli e l’accesso alle casseforti da un terminale con Devolutions CLI, e vedere quali attività offre ogni tipo di spazio di lavoro.

`devo admin` Le permette di occuparsi delle persone e delle autorizzazioni dello spazio di lavoro da un terminale o da uno script: elencare gli utenti, aggiornare un account, organizzare i gruppi e decidere chi può aprire una cassaforte. La maggior parte di queste attività dipende dal tipo di spazio di lavoro, quindi ogni tabella di questa pagina ha una colonna SPAZIO DI LAVORO. Su Devolutions Cloud e Devolutions Server, un comando che lo spazio di lavoro non offre si ferma con `operationNotSupportedBySource` e indica il tipo necessario. Un profilo locale rifiuta con un proprio codice di errore e un messaggio che spiega perché.

## Prima di iniziare

* Acceda con un account che ha diritti di amministratore sullo spazio di lavoro. Consulti [Accedere a Devolutions Cloud](/cli/it/guide/connect/devolutions-cloud.md) o [Accedere a Devolutions Server](/cli/it/guide/connect/devolutions-server.md).
* Controlli con `devo status` quale spazio di lavoro è selezionato. Aggiunga `--context <context-name>` a un comando per eseguirlo su un altro.
* I comandi che cambiano qualcosa hanno bisogno di `--yes`. Senza di esso non cambiano nulla e si arrestano con `confirmationRequired`.
* Utenti e gruppi sono selezionati per nome per impostazione predefinita. Scriva `id:<value>` o aggiunga `--id` per selezionare per ID, e `email:<value>` o `--email` per selezionare un utente per e-mail. In `devo admin group members add` e `remove`, le opzioni corrispondenti sono `--group-id`, `--user-id` e `--user-email`.

## Utenti

<table><thead><tr><th width="230">JOB</th><th>COMANDO</th><th width="210">SPAZIO DI LAVORO</th></tr></thead><tbody><tr><td>Elencare gli utenti, vedere un utente</td><td><code>devo admin user list</code><br><code>devo admin user get "&#x3C;user>"</code></td><td>Devolutions Cloud, Devolutions Server, profilo locale (sola lettura, quando il profilo lo consente)</td></tr><tr><td>Vedere i gruppi di un utente</td><td><code>devo admin user groups list "&#x3C;user>"</code></td><td>Devolutions Cloud, profilo locale (sola lettura, quando il profilo lo consente)</td></tr><tr><td>Creare un utente</td><td><code>devo admin user create "&#x3C;login>" --email &#x3C;email> --password-env &#x3C;VARIABLE_NAME> --yes</code></td><td>Devolutions Server</td></tr><tr><td>Aggiornare un utente</td><td><code>devo admin user update "&#x3C;user>" --enabled false --yes</code></td><td>Devolutions Cloud, Devolutions Server</td></tr><tr><td>Eliminare un utente</td><td><code>devo admin user delete "&#x3C;user>" --yes</code></td><td>Devolutions Cloud, Devolutions Server</td></tr></tbody></table>

Alcune opzioni di `devo admin user update` appartengono a un solo tipo di spazio di lavoro:

* **Solo Devolutions Cloud**: `--description`, `--locale`, `--workspace-access`, `--web-login` e `--user-vaults`.
* **Solo Devolutions Server**: `--first-name`, `--last-name`, `--user-type`, `--password-env`, `--password-file` e `--force-password-change`. Su Devolutions Server, cambi il nome di un utente con `--first-name` e `--last-name`: `--name` e `--display-name` non sono accettati.

Non può combinare opzioni di entrambi i tipi in un solo comando.

Su Devolutions Cloud, gli utenti sincronizzati dalla directory dell’organizzazione sono gestiti da quella directory. Devolutions CLI rifiuta di aggiornarli o di eliminarli.

{% hint style="info" %}
La password di un nuovo utente è letta da una variabile d’ambiente (`--password-env`) o da un file (`--password-file`), mai dalla riga di comando, così non finisce nella cronologia della shell.
{% endhint %}

## Gruppi

<table><thead><tr><th width="230">JOB</th><th>COMANDO</th><th width="210">SPAZIO DI LAVORO</th></tr></thead><tbody><tr><td>Elencare i gruppi, vedere un gruppo e i suoi membri</td><td><code>devo admin group list</code><br><code>devo admin group get "&#x3C;group>"</code><br><code>devo admin group members list "&#x3C;group>"</code></td><td>Devolutions Cloud, profilo locale (sola lettura, quando il profilo lo consente)</td></tr><tr><td>Creare, rinominare o eliminare un gruppo</td><td><code>devo admin group create "&#x3C;group>" --yes</code><br><code>devo admin group update "&#x3C;group>" --name "&#x3C;new-name>" --yes</code><br><code>devo admin group delete "&#x3C;group>" --yes</code></td><td>Devolutions Cloud</td></tr><tr><td>Aggiungere o rimuovere un membro</td><td><code>devo admin group members add "&#x3C;group>" "&#x3C;user>" --yes</code><br><code>devo admin group members remove "&#x3C;group>" "&#x3C;user>" --yes</code></td><td>Devolutions Cloud</td></tr></tbody></table>

Eliminare un gruppo rimuove anche le sue assegnazioni. I gruppi sincronizzati dalla directory dell’organizzazione non possono essere eliminati.

## Ruoli e accesso alla cassaforte

<table><thead><tr><th width="230">JOB</th><th>COMANDO</th><th width="210">SPAZIO DI LAVORO</th></tr></thead><tbody><tr><td>Elencare i ruoli</td><td><code>devo admin role list --scope vault</code> (or <code>--scope entry</code>)<br><code>devo admin role get &#x3C;role-id></code></td><td>Devolutions Cloud</td></tr><tr><td>Vedere chi può aprire una cassaforte</td><td><code>devo vault access list "&#x3C;vault>"</code></td><td>Devolutions Cloud</td></tr><tr><td>Dare a un utente o a un gruppo l’accesso a una cassaforte</td><td><code>devo vault access grant "&#x3C;vault>" --user "&#x3C;user>" --role Readers --yes</code></td><td>Devolutions Cloud</td></tr><tr><td>Rimuovere l’accesso di un utente o di un gruppo</td><td><code>devo vault access revoke "&#x3C;vault>" --group "&#x3C;group>" --yes</code></td><td>Devolutions Cloud</td></tr><tr><td>Vedere, assegnare o rimuovere un ruolo su una voce</td><td><code>devo entry access list --vault-id &#x3C;vault-id> --entry-id &#x3C;entry-id></code><br><code>devo entry access get --vault-id &#x3C;vault-id> --entry-id &#x3C;entry-id> --user-id &#x3C;user-id></code><br><code>devo entry access grant --vault-id &#x3C;vault-id> --entry-id &#x3C;entry-id> --user-id &#x3C;user-id> --role-id &#x3C;role-id> --yes</code><br><code>devo entry access revoke --vault-id &#x3C;vault-id> --entry-id &#x3C;entry-id> --group-id &#x3C;group-id> --yes</code></td><td>Devolutions Cloud</td></tr><tr><td>Vedere le autorizzazioni dirette di una voce</td><td><code>devo entry permission get "&#x3C;entry>"</code></td><td>Devolutions Cloud, profilo locale (quando il profilo lo consente)</td></tr><tr><td>Elencare i set di autorizzazioni</td><td><code>devo admin access permission-sets</code></td><td>Devolutions Server</td></tr></tbody></table>

`--role` accetta un nome o un ID di ruolo: `Restricted`, `Readers`, `PrivilegedReaders`, `Operators`, `PrivilegedOperators`, `Contributors` o `VaultOwners`. Ogni concessione o revoca agisce su un singolo utente (`--user`) o un singolo gruppo (`--group`).

Su un profilo locale, `devo admin role list` e `devo admin access permission-sets` non sono disponibili: gli elenchi dei ruoli sono per Devolutions Cloud e gli insiemi di autorizzazioni per Devolutions Server.

## Solo Devolutions Cloud

<table><thead><tr><th width="230">JOB</th><th>COMANDO</th><th width="210">SPAZIO DI LAVORO</th></tr></thead><tbody><tr><td>Esaminare e ripulire gli inviti</td><td><code>devo admin invitation list</code><br><code>devo admin invitation get --invitation-id &#x3C;invitation-id></code><br><code>devo admin invitation remove-email --id &#x3C;invitation-id> --email &#x3C;email> --yes</code><br><code>devo admin invitation delete --id &#x3C;invitation-id> --yes</code></td><td>Devolutions Cloud</td></tr><tr><td>Gestire le autorizzazioni di sistema</td><td><code>devo admin access system list</code><br><code>devo admin access system get --user-id &#x3C;user-id></code><br><code>devo admin access system grant --user-id &#x3C;user-id> --permission &#x3C;permission> --yes</code><br><code>devo admin access system revoke --group-id &#x3C;group-id> --permission &#x3C;permission> --yes</code></td><td>Devolutions Cloud</td></tr><tr><td>Gestire i ruoli della cassaforte di sistema</td><td><code>devo admin access system-vault list</code><br><code>devo admin access system-vault get --user-id &#x3C;user-id></code><br><code>devo admin access system-vault grant --user-id &#x3C;user-id> --role-id &#x3C;role-id> --yes</code><br><code>devo admin access system-vault revoke --group-id &#x3C;group-id> --yes</code></td><td>Devolutions Cloud</td></tr><tr><td>Esaminare o rimuovere istanze di Devolutions Gateway</td><td><code>devo admin gateway list</code><br><code>devo admin gateway get --gateway-id &#x3C;gateway-id></code><br><code>devo admin gateway settings get</code><br><code>devo admin gateway delete --gateway-id &#x3C;gateway-id> --yes</code><br><br>I risultati non includono mai i segreti dei gateway.</td><td>Devolutions Cloud</td></tr><tr><td>Vedere o cambiare il proprietario dell’organizzazione</td><td><code>devo admin owner get</code><br><code>devo admin owner set --user-id &#x3C;user-id> --yes</code></td><td>Devolutions Cloud</td></tr><tr><td>Esaminare o modificare le impostazioni di sistema</td><td><code>devo admin settings get</code><br><code>devo admin settings update --force-two-factor-authentication --yes</code></td><td>Devolutions Cloud</td></tr></tbody></table>

{% hint style="danger" %}
`devo admin access system revoke` senza `--permission` rimuove **tutte** le autorizzazioni di sistema dell’utente o del gruppo. `devo admin owner set` consegna l’organizzazione a un altro utente. Controlli gli ID prima di aggiungere `--yes`.
{% endhint %}

## Solo Devolutions Server

<table><thead><tr><th width="230">JOB</th><th>COMANDO</th><th width="210">SPAZIO DI LAVORO</th></tr></thead><tbody><tr><td>Ripristinare o eliminare definitivamente gli utenti eliminati</td><td><code>devo admin user trash list</code><br><code>devo admin user trash restore id:&#x3C;user-id> --yes</code><br><code>devo admin user trash purge id:&#x3C;user-id> --yes</code></td><td>Devolutions Server</td></tr><tr><td>Preconfigurare il metodo a due fattori di un utente</td><td><code>devo admin user 2fa set --user-security-id &#x3C;id> --type google-authenticator --yes</code><br><code>devo admin user 2fa clear --user-security-id &#x3C;id> --yes</code></td><td>Devolutions Server</td></tr><tr><td>Ispezionare i domini di Active Directory</td><td><code>devo admin domain list</code><br><code>devo admin domain users --domain &#x3C;domain-name></code></td><td>Devolutions Server</td></tr><tr><td>Esaminare o modificare le impostazioni di autenticazione</td><td><code>devo admin settings auth-modes get</code><br><code>devo admin settings auth-modes set --domain true --azure-ad false --yes</code><br><code>devo admin settings two-factor get</code><br><br><code>auth-modes set</code> attiva o disattiva l’autenticazione di dominio, Azure AD e l’autenticazione personalizzata (<code>--custom</code>) con <code>true</code> o <code>false</code>. Le opzioni che omette mantengono il loro valore. Devolutions CLI rifiuta una modifica che non lascerebbe alcuna modalità di autenticazione principale attivata.</td><td>Devolutions Server</td></tr><tr><td>Esaminare e registrare le licenze</td><td><code>devo admin license list</code><br><code>devo admin license users list --serial-env &#x3C;VARIABLE_NAME></code><br><code>devo admin license register --serial-env &#x3C;VARIABLE_NAME> --yes</code><br><code>devo admin license trial start --yes</code><br><br>Il numero di serie o il JWT della licenza proviene da una variabile d’ambiente (<code>--serial-env</code>) o da un file (<code>--serial-file</code>), mai dalla riga di comando. <code>license list</code> mostra i numeri di serie in parte nascosti. Aggiunga <code>--replace</code> per sostituire le licenze esistenti e <code>--auto-assign true</code> per assegnare automaticamente le licenze supportate ai nuovi utenti.</td><td>Devolutions Server</td></tr><tr><td>Esaminare l’accesso privilegiato</td><td><code>devo admin pam account list</code><br><code>devo admin pam provider list</code><br><code>devo admin pam provider get --provider-id &#x3C;provider-id></code><br><br><code>pam account list</code> restituisce 100 account per pagina per impostazione predefinita (<code>--page</code>, <code>--page-size</code> fino a 500), facoltativamente per una cartella (<code>--vault-id</code>). I risultati non includono le password.</td><td>Devolutions Server</td></tr><tr><td>Pubblicare gli elenchi di revoca di Devolutions Gateway</td><td><code>devo admin gateway revocation-list publish --yes</code><br><br>Aggiunga <code>--gateway-id &#x3C;gateway-id></code> per pubblicare l’elenco di un solo gateway.</td><td>Devolutions Server</td></tr></tbody></table>

Devolutions Server seleziona gli utenti eliminati solo per ID e `devo admin user trash list` non accetta lì alcun filtro del nome. `devo admin domain list` non mostra i segreti di binding del dominio.

{% hint style="danger" %}
`devo admin user trash purge` elimina l’utente in modo permanente. L’operazione non può essere annullata.
{% endhint %}

## Buono a sapersi

* Ogni comando `devo admin`, con tutte le sue opzioni, si trova nel [riferimento dei comandi](/cli/it/riferimento/commands.md).
* Aggiunga `--output json` per passare i risultati a uno script. Consulti [Leggere i risultati come JSON](/cli/it/per-devops-e-amministratori/automate/json-output.md).
* Un comando dice che lo spazio di lavoro non lo supporta? Consulti [Un comando dice che lo spazio di lavoro non lo supporta](/cli/it/aiuto/troubleshooting/not-supported.md).

## Successivo

* [Review activity logs](/cli/it/per-devops-e-amministratori/manage/logs.md)
* [Manage vaults and entries](/cli/it/per-devops-e-amministratori/manage/vaults-and-entries.md)


---

# 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/cli/it/per-devops-e-amministratori/manage/users-and-access.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.