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.
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de