Esportazione delle risorse dsc

Riepilogo

Genera un documento di configurazione che definisce le istanze esistenti di una risorsa specifica.

Sintassi

Senza proprietà di istanza

dsc resource export [Options] --resource <RESOURCE>

Proprietà di istanza dall'opzione di input

dsc resource export --input <INPUT> --resource <RESOURCE>

Proprietà di istanza da file

dsc resource export --file <FILE> --resource <RESOURCE>

Proprietà di istanza da stdin

cat <FILE> | dsc resource get [Options] --resource <RESOURCE> --file -

Descrizione

Il export sottocomando genera un documento di configurazione che include ogni istanza di una risorsa specifica. La risorsa deve essere specificata con l'opzione --resource .

A partire da DSC 3.1.0, è possibile usare l'opzione o --file per specificare un'istanza --input di risorsa da usare come filtro per le risorse esportate. In questo caso, l'istanza specificata viene passata alla risorsa per l'utilizzo nel filtro. L'implementazione per il filtro dipende da ogni risorsa, non dal DSC stesso.

Specificare le risorse esportabili solo con un manifesto della risorsa che definisce la sezione di esportazione nella configurazione di input. Se il tipo di risorsa specificato non è esportabile, DSC genera un errore.

Opzioni

-r, --risorsa

Specifica il nome completo del tipo della risorsa DSC da esportare, ad esempio Microsoft.Windows/Registry.

La sintassi completa del nome del tipo è: <owner>[.<group>][.<area>]/<name>, dove:

• È owner l'autore o l'organizzazione responsabile della risorsa.
• I group e area sono componenti facoltativi del nome che abilitano la spaziatura dei nomi per una risorsa.
• Identifica name il componente gestito dalla risorsa.

Type        : string
Mandatory   : true
LongSyntax  : --resource <RESOURCE>
ShortSyntax : -r <RESOURCE>

-i, --input

Specifica l'istanza di risorsa da utilizzare come filtro per le istanze di risorsa esportate.

L'istanza deve essere una stringa contenente un oggetto JSON o YAML. DSC convalida l'oggetto in base allo schema dell'istanza della risorsa. Se la convalida ha esito negativo, DSC genera un errore.

Questa opzione si esclude a vicenda con l'opzione --file .

Type        : string
Mandatory   : false
LongSyntax  : --input <INPUT>
ShortSyntax : -i <INPUT>

-f, --file

Definisce il percorso di un file che definisce l'istanza di risorsa da utilizzare come filtro per le istanze di risorsa esportate.

Il file specificato deve contenere un oggetto JSON o YAML che rappresenta proprietà valide per la risorsa. DSC convalida l'oggetto in base allo schema dell'istanza della risorsa. Se la convalida ha esito negativo o se il file specificato non esiste, DSC genera un errore.

Questa opzione si esclude a vicenda con l'opzione --input .

Type        : string
Mandatory   : false
LongSyntax  : --file <FILE>
ShortSyntax : -f <FILE>

-o, --formato-output

L'opzione --output-format controlla il formato utilizzato da DSC per i dati restituiti dal comando. I formati disponibili sono:

• json per emettere i dati come riga JSON.
• pretty-json per generare i dati come JSON con nuove righe, rientro e spazi per la leggibilità.
• yaml per generare i dati come YAML.

Il formato di output predefinito dipende dal fatto che DSC rilevi che l'output viene reindirizzato o acquisito come variabile:

• Se il comando non viene reindirizzato o acquisito, DSC visualizza l'output yaml come formato nella console.
• Se l'output del comando viene reindirizzato o acquisito, DSC genera i dati come json formato in stdout.

Quando si usa questa opzione, DSC usa il formato specificato indipendentemente dal fatto che il comando venga reindirizzato o acquisito.

Quando il comando non viene reindirizzato o acquisito, l'output nella console viene formattato per una migliore leggibilità. Quando il comando non viene reindirizzato o acquisito, l'output include sequenze di terminali per la formattazione.

Type        : string
Mandatory   : false
ValidValues : [json, pretty-json, yaml]
LongSyntax  : --output-format <OUTPUT_FORMAT>
ShortSyntax : -o <OUTPUT_FORMAT>

-h, --help (aiuto)

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

Type        : boolean
Mandatory   : false
LongSyntax  : --help
ShortSyntax : -h

Risultato

Questo comando restituisce dati formattati che definiscono un documento di configurazione che include ogni istanza delle risorse dichiarate nella configurazione di input. Per altre informazioni, vedere Informazioni di riferimento sullo schema del documento di configurazione DSC.

Per ulteriori informazioni sulla formattazione dei dati di output, vedere l'opzione --output-format.