Compartilhar via


exportação de configuração dsc

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 caracteres de opção

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

Documento de configuração do arquivo

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

Descrição

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 deve ser passado para esse comando como JSON ou YAML sobre stdin, como uma cadeia de caracteres com a opção de documento ou de um arquivo com a opção path .

A configuração de entrada define os recursos a serem exportados. A DSC ignora todas as propriedades especificadas para os recursos na configuração de entrada da operação, mas o documento de entrada e todas as propriedades para instâncias de recurso ainda devem ser validados no documento de configuração e nos esquemas de instância de recurso.

Especifique apenas recursos com um manifesto de recurso que define a seçã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, a DSC gerará um erro.

Opções

-d, --document

Especifica o documento de configuração do qual exportar como um objeto JSON ou YAML. A DSC valida o documento em relação ao esquema do documento de configuração. Se a validação falhar, a DSC gerará um erro.

Essa opção não pode ser usada com o documento de configuração sobre stdin ou a opção --path . Escolha se deseja passar o documento de configuração para o comando sobre stdin, de um arquivo 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 a ser exportado em vez de canalizar o documento do stdin ou passá-lo como uma cadeia de caracteres com a opção --document . O arquivo especificado deve conter um documento de configuração como um objeto JSON ou YAML. A DSC valida o documento em relação ao esquema do documento de configuração. Se a validação falhar ou se o arquivo especificado não existir, a DSC gerará um erro.

Essa opção é mutuamente exclusiva com a opção --document . Quando você usa essa opção, a DSC ignora qualquer entrada de stdin.

Type:      String
Mandatory: false

-f, --format

A --format opção controla o formato de saída do console 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

Exibe a ajuda para o comando ou subcomando atual. Quando você especifica essa opção, o aplicativo ignora todas as opções e argumentos após essa.

Type:      Boolean
Mandatory: false

Saída

Esse comando retorna a 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, consulte Referência de esquema de documento de configuração de DSC.