For the complete documentation index, see llms.txt. This page is also available as Markdown.

Comandi dei segreti

Questa pagina elenca ogni argomento e ogni opzione dei comandi che leggono, inseriscono e scrivono segreti (devo secret), collegano SecretSpec (devo secretspec) e generano password e chiavi (devo generate). Per una panoramica di tutti i comandi, consulti Comandi. Per un aiuto passo dopo passo, consulti Usare i segreti senza esporli, Eseguire un comando con i suoi segreti, Usare i segreti nella shell corrente, Compilare un file di configurazione da un modello, Aggiornare un segreto da uno script, Usare Devolutions CLI con SecretSpec e Generare password e chiavi SSH.

Le opzioni che ogni comando accetta, come --context, --source o --output json, sono in Opzioni globali. La sintassi dei riferimenti devo:// è in Sintassi dei riferimenti al segreto.

devo secret run

Esegue un comando con i riferimenti risolti solo nel suo ambiente. I valori risolti sono sostituiti con <concealed by Devolutions> in ciò che il comando stampa, a meno che non aggiunga --no-masking.

Spazio di lavoro: Tutti i tipi di spazio di lavoro

devo secret run [--env-ref <NAME>=<reference>]... [--env-file <path>] [--stdin-reference <reference>] [--timeout-seconds <seconds>] -- <command> [<arguments>]
devo secret run --manifest <path>
OPZIONE
PREDEFINITO
CHE COSA FA

-- <command> [<arguments>]

Il comando da eseguire e i suoi argomenti, dopo --. Obbligatorio, a meno che non usi --manifest. Un argomento che è un riferimento viene rifiutato: passi i riferimenti con --env-ref, --stdin-reference, --env-file o --manifest. Un riferimento dentro un argomento più lungo, come --password=devo://…, non viene rifiutato, ma non viene nemmeno risolto.

--env-ref <NAME>=<reference>

Mette il valore di un riferimento nella variabile d’ambiente NAME del comando. Ripeta per più variabili. Il nome deve usare lettere, cifre e trattini bassi e non può iniziare con una cifra. Il valore deve essere un riferimento devo:// esatto.

--env-file <path>

File di ambiente di righe KEY=value. Le righe vuote e le righe che iniziano con # sono ignorate; le virgolette intorno a un valore vengono rimosse. I valori possono essere riferimenti. Una riga senza = ferma il comando con codice di uscita 2. Una variabile del file sostituisce una variabile dell’ambiente con lo stesso nome. Consulti Togliere le password da un file .env.

--stdin-reference <reference>

Riferimento il cui valore è scritto, esattamente, nell’input standard del comando. Deve essere un riferimento devo:// esatto; funzionano sia i riferimenti con nome sia quelli canonici.

--manifest <path>

Manifesto di avvio: un file JSON con versione che contiene il comando, i suoi argomenti, i suoi riferimenti e, facoltativamente, un riferimento allo standard input, un timeout e una cartella di lavoro (una cartella assoluta esistente). Non può essere combinato con --env-ref, --env-file, --stdin-reference, --timeout-seconds o un comando dopo --. Con un manifesto, le variabili dell’ambiente che contengono un riferimento non vengono risolte.

--timeout-seconds <seconds>

Nessuno

Tempo massimo di esecuzione del comando, maggiore di zero. Quando è superato, il comando è fermato e devo esce con il codice 124. Senza, non c’è un limite di tempo.

--receipt-file <path>

Scrive una ricevuta dell’avvio al termine del comando: un file JSON con il piano di avvio, i nomi delle variabili, il codice di uscita e la durata, senza alcun valore. Il file non deve ancora esistere. Se esiste, il comando viene comunque eseguito, ma la ricevuta non viene scritta e devo termina con il codice 1 invece del codice di uscita del comando.

--check

Disattivato

Controlla che il comando esista e che i riferimenti siano ben formati, senza leggere alcun segreto né avviare il comando. Su un profilo locale, e per un riferimento con nome, controlla anche che la cassaforte e la voce esistano; su Devolutions Cloud e Devolutions Server un riferimento canonico non viene cercato. Non può essere combinato con --dry-run.

--dry-run

Disattivato

Controlla il piano di avvio e lo mostra, senza contattare lo spazio di lavoro, senza cercare il comando, senza leggere alcun segreto e senza avviare il comando. Non può essere combinato con --check.

--no-masking

Disattivato

Smette di sostituire i valori risolti con <concealed by Devolutions> in ciò che il comando stampa sul suo output standard e sul suo output di errore.

Oltre a --env-ref e --env-file, qualsiasi variabile dell’ambiente il cui valore è un riferimento devo:// viene risolta per il comando, a meno che non usi --manifest. Lo stesso nome di variabile non può provenire da due origini, per esempio un --env-ref e una variabile dell’ambiente: il comando si ferma invece.

Codici di uscita: un avvio non valido, come un --env-ref malformato oppure sia --check sia --dry-run, termina con 2 prima che venga letto qualcosa. Un timeout termina con 124, un annullamento con Ctrl+C con 130. Altrimenti devo secret run termina con il codice di uscita del comando. Consulti Codici di uscita ed errori.

devo secret read

Legge un riferimento e scrive il valore nel terminale o in un file.

Spazio di lavoro: Tutti i tipi di spazio di lavoro

OPZIONE
PREDEFINITO
CHE COSA FA

<reference>

Il riferimento da leggere, come devo://<workspace>/<vault>/<entry>/password. Obbligatorio. Un riferimento mal formato è rifiutato prima di qualsiasi lettura. Consulti Sintassi dei riferimenti al segreto.

--attribute <attribute> (--attr)

Che cosa leggere del campo: value, type, id, title o purpose, senza distinzione tra maiuscole e minuscole. otp è accettato, ma non restituisce nulla. Qualsiasi altro valore è rifiutato. Senza questa opzione si applica il ?attribute= proprio del riferimento, oppure value. Consulti Attributi.

--out-file <path> (-f)

Scrive il valore in un file invece che nel terminale. La cartella deve esistere e il percorso non può essere una cartella. Con l’output di testo non viene stampato nient’altro; con --output json, il risultato è stampato senza il valore.

--force

Disattivato

Sovrascrive il file --out-file se esiste. Senza di essa, un file esistente viene rifiutato.

--raw

Disattivato

Con l’output di testo, scrive esattamente il valore sull’output standard, senza un’interruzione di riga alla fine. Senza di essa, un’interruzione di riga segue il valore.

devo secret get

Legge un campo di una voce dello spazio di lavoro selezionato, per nome o ID della voce, senza scrivere un riferimento.

Spazio di lavoro: Tutti i tipi di spazio di lavoro

OPZIONE
PREDEFINITO
CHE COSA FA

<field>

Il campo da leggere, come password, username, domain, host, otp o privatekey. Obbligatorio. Devolutions Server legge qualsiasi proprietà di dati della voce.

<entry>

Il nome della voce, o il suo ID con id:<value> o --id. Obbligatorio.

--id

Disattivato

Tratta <entry> come un ID.

--workspace <workspace>

Spazio di lavoro corrente

Spazio di lavoro della voce, per nome o per ID.

--vault <vault>

Cassaforte corrente

Cassaforte della voce, per nome o per ID.

--vault-id <id>

Cassaforte della voce, per ID. Ha la priorità su --vault. Con un ID di voce e nessuna opzione di cassaforte, è usata la cassaforte corrente; se nessuna cassaforte è selezionata, il comando chiede --vault-id.

--section <section>

Sezione del campo, quando il campo è in una sezione. Non può essere combinata con un ID di voce né con le opzioni della passphrase.

--attribute <attribute> (--attr)

value

Che cosa leggere sul campo: value, type, id, title o purpose. otp è accettato, ma non restituisce nulla. Con un’opzione di passphrase è accettato solo value.

--passphrase-env <variable>

Solo profilo locale: nome della variabile d’ambiente che contiene la passphrase di uno spazio di lavoro protetto. Rifiutato su Devolutions Cloud e Devolutions Server. Richiede l’ID della voce (id:<value> o --id). Con un’opzione di passphrase si può leggere solo il campo password, si può indicare solo una delle due opzioni di passphrase, si accetta solo l’output di testo e, senza --vault-id o --vault, si usa la cassaforte predefinita dello spazio di lavoro.

--passphrase-file <path>

Solo profilo locale: file privato che contiene la passphrase di uno spazio di lavoro protetto. Le stesse regole di --passphrase-env.

--out-file <path> (-f)

Scrive il valore in un file invece che nel terminale. Le stesse regole di devo secret read.

--force

Disattivato

Sovrascrive il file --out-file se esiste.

--raw

Disattivato

Con output di testo, scrive esattamente il valore sull’output standard, senza un’interruzione di riga alla fine.

devo secret set

Scrive un campo segreto di una voce, con il nuovo valore da una variabile d’ambiente o da un file. Il nuovo valore non viene mai stampato.

Spazio di lavoro: Tutti i tipi di spazio di lavoro. Devolutions Server scrive qualsiasi proprietà dei dati della voce; Devolutions Cloud e i profili locali scrivono solo password.

OPZIONE
PREDEFINITO
CHE COSA FA

<field>

Il campo da scrivere. Obbligatorio. Su Devolutions Cloud e su un profilo locale, qualsiasi campo diverso da password è rifiutato con un errore che dice che lo spazio di lavoro accetta scritture solo nel campo della password.

<entry>

Il nome della voce, o il suo ID con id:<value> o --id. Obbligatorio.

--id

Disattivato

Tratta <entry> come un ID.

--vault-id <id>

Cassaforte della voce, per ID. Su un profilo locale, con un ID di voce e senza --vault-id, è usata la cassaforte predefinita dello spazio di lavoro. Su Devolutions Cloud, senza, è usata la cassaforte corrente.

--value-env <variable>

Nome della variabile d’ambiente che contiene il nuovo valore. Usi esattamente uno tra --value-env o --value-file.

--value-file <path>

File che contiene il nuovo valore.

--passphrase-env <variable>

Solo profilo locale: nome della variabile d’ambiente che contiene la passphrase di uno spazio di lavoro protetto. Rifiutata su Devolutions Cloud e Devolutions Server.

--passphrase-file <path>

<workspace file>.passphrase

Solo profilo locale: file privato che contiene la passphrase di uno spazio di lavoro protetto. Senza alcuna opzione di passphrase, viene usato il file <workspace file>.passphrase nella cartella del profilo. Rifiutato su Devolutions Cloud e Devolutions Server.

--yes (-y, --confirmed)

Disattivato

Conferma la modifica. Obbligatorio: senza di essa non viene scritto nulla.

devo secret inject

Sostituisce i riferimenti in un testo, dall’input standard o da un file, con i loro valori.

Spazio di lavoro: Tutti i tipi di spazio di lavoro

OPZIONE
PREDEFINITO
CHE COSA FA

--in-file <path> (-i)

Input standard

Modello da leggere.

--out-file <path> (-f)

Output standard

File da scrivere. La cartella deve esistere e il percorso non può essere una cartella.

--force

Disattivato

Sovrascrive il file --out-file se esiste. Senza di essa, un file esistente viene rifiutato.

Se un riferimento nel modello non può essere risolto, non viene scritto nulla e il comando termina con il codice 1. Con --output json o --output yaml, il comando stampa un riepilogo invece del testo compilato: usi --out-file per ottenere il testo. Consulti Compilare un file di configurazione da un modello.

devo secret shell enter

Stampa codice shell che carica i riferimenti nella sessione Bash o PowerShell corrente. Esegua quel codice con eval (Bash) o Invoke-Expression (PowerShell). Consulti Usare i segreti nella shell corrente.

Spazio di lavoro: Tutti i tipi di spazio di lavoro

OPZIONE
PREDEFINITO
CHE COSA FA

--shell <shell>

Shell per cui scrivere il codice: bash oppure pwsh (powershell funziona allo stesso modo). Obbligatorio. Qualsiasi altro valore viene rifiutato.

--env-ref <NAME>=<reference>

Variabile da caricare e il suo riferimento. Ripeta per più variabili. Almeno una è obbligatoria. Ogni nome deve essere univoco, senza distinzione tra maiuscole e minuscole. Il comando non legge l’ambiente né i file .env.

--check

Disattivato

Controlla i riferimenti, come fa devo secret run --check, senza leggere alcun segreto né scrivere codice di shell. Richiede --output json.

Senza --check, il comando ha bisogno di un output di testo, così la shell può eseguire ciò che stampa. Se un riferimento non può essere letto, non viene stampato nulla sull’output standard e il comando esce con un codice diverso da zero.

devo secret shell leave

Stampa codice di shell che annulla il devo secret shell enter più recente, ripristinando ogni variabile com’era prima.

Spazio di lavoro: Tutti i tipi di spazio di lavoro

OPZIONE
PREDEFINITO
CHE COSA FA

--shell <shell>

Shell per cui scrivere il codice: bash o pwsh (powershell fa lo stesso). Obbligatorio. Usi lo stesso valore di enter. Il comando ha bisogno di un output di testo.

devo secret shell status

Mostra se un ambito di devo secret shell enter è attivo nella shell corrente, quanti ambiti sono annidati e i nomi delle variabili impostate dal più recente. Non mostra mai i valori.

Spazio di lavoro: Tutti i tipi di spazio di lavoro

OPZIONE
PREDEFINITO
CHE COSA FA

--shell <shell>

Shell da ispezionare: bash o pwsh (powershell fa la stessa cosa). Obbligatorio. Il comando ha bisogno di --output json.

devo secret catalog entry

Elenca i riferimenti devo:// dei campi di una voce, pronti da copiare, senza alcun valore. Uguale a devo entry references. Consulti Trovare il riferimento a un segreto.

Spazio di lavoro: Tutti i tipi di spazio di lavoro

OPZIONE
PREDEFINITO
CHE COSA FA

<entry>

Il nome della voce, o il suo ID con id:<value> o --id. Obbligatorio.

--id

Disattivato

Tratta <entry> come un ID.

--vault-id <id>

Cassaforte della voce, per ID. Su Devolutions Cloud, senza un’opzione di cassaforte, viene usata la cassaforte corrente.

--vault-name <name>

Cassaforte della voce, per nome.

devo secret capabilities

Descrive, per Devolutions Cloud, Devolutions Server e i profili locali, ciò che i comandi dei segreti supportano, come quali campi possono essere letti e scritti. Non viene restituito alcun valore e nessuno spazio di lavoro viene contattato.

Spazio di lavoro: Tutti i tipi di spazio di lavoro

Questo comando non ha argomenti né opzioni propri.

devo secretspec register

Registra questo devo come provider SecretSpec per gli URI del provider devo://, scrivendo un file di claim devo.secretspec.json. Consulti Usare Devolutions CLI con SecretSpec per sapere dove va il file.

Spazio di lavoro: Tutti i tipi di spazio di lavoro

OPZIONE
PREDEFINITO
CHE COSA FA

--system

Disattivato

Scrive il claim per ogni utente del computer invece che solo per lei. Di solito servono diritti di amministratore.

--executable <path>

Questo devo

L’eseguibile devo da registrare. Il percorso deve essere assoluto e il file deve esistere. Un percorso verso l’host dotnet è rifiutato: registri l’eseguibile devo pubblicato.

--environment <name> (--env)

Variabile d’ambiente aggiuntiva che SecretSpec può passare a devo, per nome esatto o per un prefisso che termina con *, come DEVO_*. La ripeta per più di una. Un nome usa lettere, cifre e trattini bassi e non può iniziare con una cifra; qualsiasi altra cosa è rifiutata. RDM_CONFIG_PATH e DEVO_CLI_CONFIG_HOME sono sempre inclusi.

--force

Disattivato

Sostituisce un claim esistente che registra un eseguibile che non è un eseguibile devo. Un claim che punta a un altro eseguibile devo è sostituito senza --force.

--dry-run

Disattivato

Mostra il claim che verrebbe scritto, senza scriverlo.

Se lo stesso claim è già presente, non viene scritto nulla e il comando lo segnala come invariato.

devo secretspec unregister

Rimuove il claim devo.secretspec.json, così SecretSpec non avvia più Devolutions CLI. Se non c’è alcun claim, il comando lo segnala come assente.

Spazio di lavoro: Tutti i tipi di spazio di lavoro

OPZIONE
PREDEFINITO
CHE COSA FA

--system

Disattivato

Rimuove il claim per ogni utente del computer invece del proprio.

--dry-run

Disattivato

Mostra il claim che verrebbe rimosso, senza rimuoverlo.

devo secretspec status

Mostra il claim dell’utente e il claim del computer e, per ciascuno, se punta al devo in esecuzione.

Spazio di lavoro: Tutti i tipi di spazio di lavoro

Questo comando non ha argomenti né opzioni propri.

devo secretspec uri

Stampa l’URI del provider da mettere in secretspec.toml per lo spazio di lavoro selezionato: quello indicato con --source o --context, oppure il contesto corrente.

Spazio di lavoro: Tutti i tipi di spazio di lavoro

OPZIONE
PREDEFINITO
CHE COSA FA

--vault-id <id>

Cassaforte predefinita del provider. Un segreto può ancora nominare la propria cassaforte. Senza di essa, ogni segreto deve nominare la sua cassaforte.

--workspace-id <id>

Solo profilo locale, e lì obbligatorio: l’ID dello spazio di lavoro, scritto sqlite:<file-name>.db, come sqlite:Connections.db. devo workspace current lo mostra. Rifiutato per Devolutions Cloud e Devolutions Server, i cui URI selezionano invece un contesto.

devo secretspec provider

Serve il protocollo di provider di SecretSpec su input e output standard. SecretSpec lo avvia da solo tramite il claim registrato; non lo esegue lei.

Spazio di lavoro: Tutti i tipi di spazio di lavoro

Questo comando non ha argomenti né opzioni propri.

devo generate password

Genera una password casuale robusta sul computer. Contiene sempre almeno una lettera minuscola, una lettera maiuscola, una cifra e un simbolo da !@#$%^&*?. Come ogni comando devo generate, non contatta alcuno spazio di lavoro e non avvia il processo in background.

Spazio di lavoro: Tutti i tipi di spazio di lavoro (funziona solo sul computer)

OPZIONE
PREDEFINITO
CHE COSA FA

--length <length>

32

Lunghezza della password, da 8 a 4096. 0 o un valore negativo significa il valore predefinito, 32. Qualsiasi altro valore fuori dall’intervallo viene rifiutato.

devo generate human-readable

Genera una password facile da leggere: sillabe minuscole pronunciabili, poi cifre, poi simboli.

Spazio di lavoro: Tutti i tipi di spazio di lavoro (funziona solo sul computer)

OPZIONE
PREDEFINITO
CHE COSA FA

--syllables <count>

4

Numero di sillabe, ciascuna una consonante e una vocale, da 1 a 64.

--numerics <count>

1

Numero di cifre aggiunte dopo le sillabe, da 0 a 64.

--symbols <count>

1

Numero di simboli da !@#$%^&*? aggiunti alla fine, da 0 a 64.

devo generate passphrase

Genera una passphrase composta da parole casuali di un dizionario.

Spazio di lavoro: Tutti i tipi di spazio di lavoro (funziona solo sul computer)

OPZIONE
PREDEFINITO
CHE COSA FA

--words <count>

5

Numero di parole, da 1 a 64.

--separator <text>

-

Testo posto tra le parole. Un valore vuoto significa il valore predefinito, -.

--dictionary <dictionary>

English

Elenco di parole: English (o en), French (o fr) o German (o de), in qualsiasi combinazione di maiuscole. Qualsiasi altro valore è rifiutato.

devo generate pattern

Genera una password da un modello, un carattere per lettera del modello.

Spazio di lavoro: Tutti i tipi di spazio di lavoro (funziona solo sul computer)

OPZIONE
PREDEFINITO
CHE COSA FA

<pattern>

Lo schema. Obbligatorio, fino a 4096 lettere. Ogni lettera dà un carattere: u lettera maiuscola, l lettera minuscola, d cifra, s simbolo da !@#$%^&*?, x uno qualsiasi di questi. Le lettere sono accettate in qualsiasi combinazione di maiuscole e minuscole; qualsiasi altro carattere è rifiutato. Per esempio, uulldds.

--shuffle

Disattivato

Mescola i caratteri generati, così il loro ordine non segue più il modello.

devo generate ssh-key

Genera una coppia di chiavi RSA sul computer: una chiave privata in formato PEM, cifrata quando indica una passphrase, e una chiave pubblica in formato OpenSSH. Viene stampata anche la chiave pubblica.

Spazio di lavoro: Tutti i tipi di spazio di lavoro (funziona solo sul computer)

OPZIONE
PREDEFINITO
CHE COSA FA

--out-file <path>

File della chiave privata. Obbligatorio. La cartella deve esistere. Su macOS e Linux, solo l’account utente può leggere il file.

--public-out-file <path>

<out-file>.pub

File della chiave pubblica. Deve essere diverso da --out-file.

--algorithm <algorithm>

rsa

Algoritmo della chiave. rsa è l’unico valore supportato.

--bits <bits>

3072

Dimensione della chiave RSA: 2048, 3072 o 4096. Qualsiasi altro valore viene rifiutato.

--comment <text>

Il suo nome utente

Commento alla fine della chiave pubblica. Non può contenere caratteri di controllo.

--passphrase-env <variable>

Nome della variabile d’ambiente che contiene la passphrase che protegge la chiave privata. La variabile deve essere impostata e non vuota. Usi questa opzione o --passphrase-file, non entrambe. Senza nessuna delle due, la chiave privata non è crittografata.

--passphrase-file <path>

File che contiene la passphrase. Il file deve esistere e non essere vuoto; le interruzioni di riga alla fine vengono ignorate.

--force

Disattivato

Sovrascrive i file di chiave se esistono. Senza di essa, un file esistente viene rifiutato.

Successivo

Ultimo aggiornamento

È stato utile?