dsc

  • Articolo

Riepilogo

Applicare la configurazione o richiamare risorse specifiche per gestire i componenti software.

Sintassi

dsc [Options] <COMMAND>

Comandi

completer

Il completer comando restituisce uno script della shell che, quando eseguito, registra i completamenti per la shell specificata. Per altre informazioni, vedere Completer.

config

Il config comando gestisce un documento di configurazione DSC. È possibile usare Playground per:

  • Ottiene lo stato corrente della configurazione.
  • Verificare se una configurazione è nello stato desiderato.
  • Impostare una configurazione sullo stato desiderato.

Per altre informazioni, vedere config.

Risorsa

Il resource comando gestisce una risorsa DSC. È possibile usare Playground per:

  • Elencare le risorse disponibili.
  • Ottenere lo schema JSON per le istanze di una risorsa.
  • Ottenere lo stato corrente di un'istanza di risorsa.
  • Verificare se un'istanza della risorsa è nello stato desiderato.
  • Impostare un'istanza della risorsa sullo stato desiderato.

Per altre informazioni, vedere risorsa

schema

Il schema comando restituisce lo schema JSON per un tipo DSC specifico. Per altre informazioni, vedere Schema.

help

Il help comando restituisce informazioni della Guida per dsc, un comando o un sottocomando.

Per ottenere la Guida per un comando o un sottocomando, usare la sintassi:

dsc help <COMMAND> [<SUBCOMMAND>]

Ad esempio, dsc help config ottiene la Guida per il config sottocomando. dsc help config set ottiene la Guida per il config set sottocomando.

È anche possibile usare l'opzione --help in un comando per visualizzare le informazioni della Guida. Ad esempio, dsc config --help o dsc config set --help.

Opzioni

-h, --help

Visualizza la Guida per il comando o il sottocomando corrente. Quando si specifica questa opzione, l'applicazione ignora tutte le opzioni e gli argomenti dopo questo.

Type:      Boolean
Mandatory: false

-l, --trace-level

Definisce il livello minimo di messaggio che deve essere generato da DSC durante un'operazione. I messaggi in DSC sono classificati in base al livello.

L'elenco seguente mostra i livelli di messaggio validi dal livello più alto a quello più basso. Quando questa opzione è impostata su qualsiasi valore nell'elenco, DSC genera messaggi a tale livello e versioni successive.

  • error
  • warning (impostazione predefinita)
  • info
  • debug
  • trace

Avviso

L'output del trace livello genera tutti gli input/output JSON elaborati da DSC durante l'esecuzione. DSC non esegue la purificazione del codice JSON prima di emetterlo. Questo livello di traccia è destinato solo agli sviluppatori. Non reindirizzare trace mai l'output a livello di archiviazione perché può contenere informazioni riservate.

Ad esempio, quando il livello di log è debug, DSC genera messaggi per ogni livello di log, ad eccezione tracedi . Quando il livello di log è error, DSC genera solo messaggi di errore. DSC ignora ogni messaggio con un livello di log inferiore.

Type:         String
Mandatory:    false
DefaultValue: warning
ValidValues:  [error, warning, info, debug, trace]

-f, --trace-format

Definisce il formato di output da utilizzare per la creazione di messaggi di traccia in stderr. DSC supporta i formati seguenti:

  • default - Genera il messaggio con la colorazione della console ANSI per il timestamp, il livello del messaggio e il numero di riga.
  • plaintext - Come default ma senza colori della console.
  • json - Genera ogni messaggio come oggetto JSON compresso con timestamp, livello, messaggio e numero di riga come proprietà.
Type:         String
Mandatory:    false
DefaultValue: default
ValidValues:  [default, plaintext, json]

-V, --version

Visualizza la versione dell'applicazione. Quando si specifica questa opzione, l'applicazione ignora tutte le opzioni e gli argomenti dopo questo.

Type:      Boolean
Mandatory: false

Variabili di ambiente

Per impostazione predefinita, il dsc comando cerca i manifesti delle risorse DSC basate su comandi nelle cartelle definite dalla PATH variabile di ambiente. Se la DSC_RESOURCE_PATH variabile di ambiente è definita, dsc cerca le cartelle invece DSC_RESOURCE_PATH di PATH.

L'ambiente DSC_RESOURCE_PATH deve essere una variabile di ambiente che segue le stesse convenzioni della PATH variabile di ambiente per il sistema operativo. Separare i percorsi delle cartelle con un punto e virgola (;) in Windows e due punti (:) in altre piattaforme.

Codici di uscita

Il dsc comando usa codici di uscita semantica. Ogni codice di uscita rappresenta un risultato diverso per l'esecuzione del comando.

Codice di uscita Significato
0 Il comando è stato eseguito correttamente senza errori.
1 Il comando non è riuscito perché ha ricevuto argomenti non validi.
2 Il comando non è riuscito perché una risorsa ha generato un errore.
3 Il comando non è riuscito perché non è stato possibile serializzare o deserializzare un valore da JSON.
4 Il comando non è riuscito perché l'input per il comando non è valido YAML o JSON.
5 Il comando non è riuscito perché una definizione di risorsa o un valore di istanza non è valido per lo schema JSON.
6 Il comando è stato annullato da un'interruzione di CTRL+C .