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:
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.
Elenchi le casseforti che può vedere:
devo vault listNe renda una quella corrente:
devo vault use "<vault-name>"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.
Trovare voci
Cerchi nella cassaforte corrente, o in un’altra, per testo, tipo o cartella:
--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:
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.
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.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.
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-idsi ferma consqliteEntryCreateVaultUnsupported.Imposti la sua password da una variabile d’ambiente o da un file, così il valore non compare mai sulla riga di comando:
Consulti Aggiornare un segreto da uno script.
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,--usernamee--domain.--host-porte--password-secret-referencevengono rifiutati.Devolutions Server:
--host,--usernamee--domain.Devolutions Cloud: solo la password, con
devo secret set.
Organizzare le voci
Questi comandi sono disponibili su un profilo locale.
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
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
--yesconferma la modifica. Senza, il comando non cambia nulla e si ferma conconfirmationRequired. Consulti Eseguire senza richieste.Aggiunga
--output jsonper ottenere un risultato che uno script possa leggere. Consulti Leggere i risultati come JSON.Un comando si ferma con
operationNotSupportedBySource(Devolutions Cloud, Devolutions Server) o con un altro codice che dice che il profilo locale non può farlo? Lo spazio di lavoro selezionato non può fare quella modifica. Consulti Un comando indica che lo spazio di lavoro non lo supporta.
Successivo
Ultimo aggiornamento
È stato utile?