exportação de configuração do dsc

Artigo
03/06/2024

Sinopse

Gera um documento de configuração que define as instâncias existentes de um conjunto de recursos.

Syntax

Documento de configuração do stdin

<document-string> | dsc config export [Options]

Documento de configuração da cadeia de opções

dsc config export [Options] --document <document-string>

Documento de configuração do ficheiro

dsc config export [Options] --path <document-filepath>

Description

O export subcomando gera um documento de configuração que inclui todas as instâncias de um conjunto de recursos.

O documento de configuração tem de ser transmitido para este comando como JSON ou YAML através de stdin, como uma cadeia com a opção de documento ou a partir de um ficheiro com a opção caminho .

A configuração de entrada define os recursos a exportar. O DSC ignora quaisquer propriedades especificadas para os recursos na configuração de entrada para a operação, mas o documento de entrada e quaisquer propriedades das instâncias de recursos ainda têm de ser validadas relativamente aos esquemas do documento de configuração e da instância de recurso.

Especifique apenas recursos com um manifesto de recurso que defina a secção de exportação na configuração de entrada. Defina apenas cada tipo de recurso uma vez. Se o documento de configuração incluir qualquer instância de recurso em que o tipo de recurso não seja exportável ou já tenha sido declarado na configuração, o DSC gera um erro.

Opções

-d, --document

Especifica o documento de configuração a exportar de como um objeto JSON ou YAML. O DSC valida o documento relativamente ao esquema do documento de configuração. Se a validação falhar, o DSC gera um erro.

Esta opção não pode ser utilizada com o documento de configuração por stdin ou com a opção --path . Escolha se pretende transmitir o documento de configuração para o comando por stdin, a partir de um ficheiro com a opção --path ou com a opção --document .

Type:      String
Mandatory: false

-p, --path

Define o caminho para um documento de configuração para exportar em vez de encaminhar o documento de stdin ou transmiti-lo como uma cadeia com a opção --document . O ficheiro especificado tem de conter um documento de configuração como um objeto JSON ou YAML. O DSC valida o documento relativamente ao esquema do documento de configuração. Se a validação falhar ou se o ficheiro especificado não existir, o DSC gera um erro.

Esta opção é mutuamente exclusiva com a opção --document . Quando utiliza esta opção, o DSC ignora qualquer entrada de stdin.

Type:      String
Mandatory: false

-f, --format

A --format opção controla o formato de saída da consola para o comando . Se a saída do comando for redirecionada ou capturada como uma variável, a saída será sempre JSON.

Type:         String
Mandatory:    false
DefaultValue: yaml
ValidValues:  [json, pretty-json, yaml]

-h, --help

Apresenta a ajuda do comando ou subcomando atual. Quando especifica esta opção, a aplicação ignora todas as opções e argumentos após esta.

Type:      Boolean
Mandatory: false

Saída

Este comando devolve uma saída JSON que define um documento de configuração, incluindo todas as instâncias dos recursos declarados na configuração de entrada. Para obter mais informações, veja DSC Configuration document schema reference (Referência do esquema do documento de Configuração do DSC).

Partilhar via