For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to page URLs.
Vai al contenuto

Gestire casseforti e voci

Usi devo vault e devo entry per scorrere lo spazio di lavoro e tenerlo ordinato da un terminale o da uno script: scelga la cassaforte in cui lavora, trovi una voce, ne crei una, la aggiorni, la sposti o la elimini. I comandi sono gli stessi per ogni tipo di spazio di lavoro, ma ogni tipo consente modifiche diverse. La tabella alla fine di questa pagina li riassume.

Questi comandi lavorano sul contesto corrente. Per verificare quale spazio di lavoro sia, esegua devo status. Per usarne un altro per un solo comando, aggiunga --context <context-name>. Consulti Passare da uno spazio di lavoro all’altro.

Vedere e selezionare spazi di lavoro

devo workspace list mostra gli spazi di lavoro che può usare, con nome, ID, tipo e se sono disponibili. Quello corrente è contrassegnato con *. devo workspace current mostra solo quello corrente.

In un profilo locale di Devolutions Remote Desktop Manager può anche selezionare, creare ed eliminare spazi di lavoro:

TO
ESECUZIONE

Selezionare lo spazio di lavoro in cui lavora

devo workspace use "<workspace-name>" Usi id:<workspace-id> per selezionarlo per ID.

Creare uno spazio di lavoro SQLite

devo workspace create "<workspace-name>" --passphrase-file <passphrase-file> --yes Il file di database è <workspace-name>.db nella cartella del profilo, a meno che non indichi un altro nome di file con --path. La passphrase protegge il nuovo spazio di lavoro; può anche provenire da una variabile d’ambiente con --passphrase-env. Il nuovo spazio di lavoro diventa quello corrente, a meno che non aggiunga --no-set-current.

Eliminare uno spazio di lavoro

devo workspace delete id:<workspace-id> --yes Usi l’ID esatto che devo workspace list mostra. Questo elimina il file di database dello spazio di lavoro, e i suoi file temporanei, dalla cartella del profilo: non si può annullare. Disponibile solo su Windows; su macOS e Linux il comando si ferma con sqliteWorkspaceDeleteUnsupported.

Selezionare la cassaforte in cui lavora

La maggior parte dei comandi delle voci usa la cassaforte corrente. Su Devolutions Cloud e Devolutions Server, un comando che legge le voci ne ha bisogno di una: una cassaforte corrente, oppure --vault-name o --vault-id sul comando.

  1. Elenchi le casseforti che può vedere:

    devo vault list
  2. Ne renda una quella corrente:

    devo vault use "<vault-name>"
  3. Verifichi quale cassaforte è quella corrente:

    devo vault current

Per lavorare in un’altra cassaforte per un solo comando senza cambiare quella corrente, aggiunga --vault-name "<vault-name>" o --vault-id <vault-id> a quel comando.

Per vedere i dettagli di una cassaforte, esegua devo vault get "<vault-name>". Su un profilo locale, devo vault settings get mostra le impostazioni radice della cassaforte corrente (o della cassaforte che nomina), e devo vault template list elenca i modelli di cassaforte.

I comandi selezionano una cassaforte, una voce, un utente o un gruppo per nome per impostazione predefinita. Quando due elementi condividono un nome, o un nome è difficile da digitare, selezioni per ID: scriva id:<value> o aggiunga --id. Per esempio, devo vault use id:<vault-id>.

Trovare voci

Cerchi nella cassaforte corrente, o in un’altra, per testo, tipo o cartella:

OPZIONE
CHE COSA FA

--type

Mantiene un solo tipo di voce. devo entry types elenca gli identificatori di tipo.

--group

Mantiene solo le voci sotto un percorso di cartella.

--limit

Numero massimo di voci restituite. Il valore predefinito è 100.

--smart-folder

Pensato per elencare le voci di una cartella intelligente, ma nessun tipo di spazio di lavoro valuta le cartelle intelligenti: il comando si ferma con smartFolderUnavailable. Filtri invece con --group o --type.

Per vedere una voce, usi devo entry get "<entry-name>". Nessuno dei due comandi mostra valori segreti. Per usare un segreto, trovi il riferimento con devo entry references e consulti Trovare il riferimento a un segreto.

Su un profilo locale, devo entry sealed list elenca le voci sigillate, con lo stesso tipo di filtri (--name, --type, --group, --limit), e devo entry template list elenca i modelli di voce.

Leggere e modificare i dettagli di una voce

Oltre ai segreti, una voce contiene dettagli che non sono segreti: host, nome utente o dominio, allegati, pagine di documentazione o parametri del comando. Questi comandi li leggono e li modificano. Nessuno mostra un valore segreto.

Leggere o modificare un campo. devo entry field get restituisce un solo valore, il che è comodo in uno script:

Legge name, type, group, host, username, domain, port o un’altra proprietà della voce, come una proprietà di metadati. Su Devolutions Server tornano solo l’ID, il nome, il tipo, la cartella e la cassaforte: host e username sono vuoti. Consulti Comandi delle voci. Per modificare un campo, usi devo entry field set con il nuovo valore in --value, oppure da --value-env o --value-file:

devo entry field set modifica gli stessi campi di devo entry update: host, username e domain su Devolutions Server e un profilo locale, e name solo su un profilo locale. Rifiuta password: per cambiare una password, usi devo secret set. Consulti Aggiornare un segreto da uno script.

Altri dettagli di una voce, su un profilo locale:

TO
ESECUZIONE

Elencare i campi di metadati

devo entry metadata list "<entry-name>" Può anche selezionare la voce dal suo percorso: path:<entry-path>.

Elencare gli allegati

devo entry attachment list "<entry-name>"

Leggere una pagina di documentazione

devo entry documentation list <entry-id> devo entry documentation get <entry-id> --title "<page-title>" Questi comandi prendono l’ID della voce.

Rinominare una pagina di documentazione

devo entry documentation update <entry-id> --title "<page-title>" --new-title "<new-title>" --yes Un profilo locale non può modificare il contenuto di una pagina.

Elencare e modificare i parametri di comando

devo entry parameter list "<entry-name>" devo entry parameter set "<entry-name>" --label "<label>" --new-label "<new-label>" --yes Selezioni il parametro con --label o --position. Può cambiarne l’etichetta (--new-label), il tipo (--type: Text, Secured, EnvironmentVariable o Unused) o il valore predefinito (--value, --value-env o --value-file). --include-unused elenca anche gli slot di parametro inutilizzati.

Elencare gli elementi di una voce Elenco di password

devo entry password-list list "<entry-name>" --name "<item-name>" --name filtra gli elementi per nome. Le password e i campi personalizzati sensibili tornano vuoti.

Creare e aggiornare casseforti

Creare, rinominare ed eliminare casseforti è disponibile su Devolutions Cloud e Devolutions Server.

  1. Creare una cassaforte:

    Per creare più casseforti insieme, usi devo vault create-many "<name-1>" "<name-2>" --yes. Devolutions CLI indica quali sono state create e quali non sono riuscite.

  2. Rinomini una cassaforte o ne cambi la descrizione:

Creare e aggiornare voci

La creazione di voci è disponibile su un profilo locale di Devolutions Remote Desktop Manager.

Entrambi i comandi sotto scrivono nello spazio di lavoro locale, quindi hanno bisogno della sua passphrase: passi --passphrase-file <file> o --passphrase-env <VARIABLE_NAME>, oppure la tenga in un file <workspace file>.passphrase nella cartella del profilo. Senza una delle due, si fermano con missingParameter.

  1. Crei la voce. Un profilo locale crea solo voci RDP:

    La voce va nella cassaforte predefinita: un profilo locale crea voci solo lì, e un altro --vault-id si ferma con sqliteEntryCreateVaultUnsupported.

  2. Imposti la sua password da una variabile d’ambiente o da un file, così il valore non compare mai sulla riga di comando:

Per modificare una voce esistente, usi devo entry update con i campi da modificare:

Ciò che può modificare dipende dal tipo di spazio di lavoro:

  • Profilo locale: --new-name, --host, --username e --domain. --host-port e --password-secret-reference vengono rifiutati.

  • Devolutions Server: --host, --username e --domain.

  • Devolutions Cloud: solo la password, con devo secret set.

Organizzare le voci

Questi comandi sono disponibili su un profilo locale.

TO
ESECUZIONE

Spostare le voci in un’altra cartella

devo entry move --entry-id <entry-id> --destination-group "<folder>" --yes Ripeta --entry-id per spostare più voci. Un profilo locale sposta le voci solo dentro la loro cassaforte: un --to-vault diverso si ferma con entryMoveCrossVaultUnsupported. Un --destination-group vuoto le sposta nella radice della cassaforte.

Rinominare una cartella

devo entry folder rename "<folder-path>" --new-name "<new-name>" --yes Anche i percorsi delle voci all’interno della cartella vengono aggiornati.

Impostare lo stato di una voce

devo entry status set "<entry-name>" --status Locked --message "<reason>" --yes Valori di stato: Archived, Broken, Default, Disabled, Expired, Locked o Warning. Per selezionare la voce per ID con questo comando e devo entry tag set, aggiunga --id: questi due comandi non riconoscono il prefisso id:.

Sostituire i tag di una voce

devo entry tag set "<entry-name>" --tag <tag-1> --tag <tag-2> --yes I tag che passa sostituiscono quelli esistenti. Usi --clear per rimuoverli tutti.

Per rileggerli, usi devo entry status get e devo entry tag list. Questi due comandi si fermano con entryFieldNotFound quando la voce non ha uno stato o non ha tag, e sempre su Devolutions Cloud e Devolutions Server, che non li restituiscono. Per vedere le voci che sono state eliminate, usi devo entry trash list, con --before <date> per vedere solo quelle eliminate prima di una data.

Eliminare voci e casseforti

Eliminare voci e casseforti è disponibile su Devolutions Cloud e Devolutions Server.

Eliminare una voce:

Su Devolutions Cloud, eliminare una voce elimina anche le voci al suo interno. Devolutions CLI rifiuta di farlo finché non aggiunge --acknowledge-recursive-scope, il che mostra che lo sa.

Eliminare una cassaforte:

Su Devolutions Cloud, selezioni la cassaforte per il suo ID: un nome di cassaforte o la cassaforte corrente non è accettato. La cassaforte va nel cestino, a meno che non aggiunga --permanently.

Che cosa può fare ogni tipo di spazio di lavoro

JOB
PROFILO LOCALE
DEVOLUTIONS CLOUD
DEVOLUTIONS SERVER

Elencare gli spazi di lavoro, mostrare quello corrente

Sì

Sì

Sì

Selezionare, creare ed eliminare spazi di lavoro

Sì

No

No

Elencare e selezionare casseforti

Sì

Sì

Sì

Creare, rinominare ed eliminare casseforti

No

Sì

Sì

Elencare, cercare e ottenere voci

Sì

Sì

Sì

Creare voci

Voci RDP

No

No

Leggere un campo (devo entry field get)

Sì

Sì

Solo ID, nome, tipo, cartella e cassaforte

Aggiornare le voci (devo entry update, devo entry field set)

Sì*

No (password con devo secret set)

Host, nome utente, dominio

Metadati, allegati, documentazione, parametri di comando, elementi di Elenco di password

Sì*

No

No

Spostare voci, rinominare cartelle

Sì*

No

No

Leggere e impostare lo stato e i tag

Sì*

No

No

Eliminare voci

No

Sì, con --acknowledge-recursive-scope

Sì

Elencare le voci eliminate

Sì

No

No

* Quando il profilo lo consente. devo doctor elenca le operazioni che lo spazio di lavoro selezionato supporta. Se una modifica non è disponibile nel profilo, la faccia in Devolutions Remote Desktop Manager.

Buono a sapersi

Successivo

Ultimo aggiornamento

È stato utile?