Teste de configuração DSC

Sinopse

Verifica se as instâncias de recurso em um documento de configuração estão no estado desejado.

Sintaxe

Documento de configuração do arquivo

dsc config test [Options] --file <FILE>

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

dsc config test [Options] --input <INPUT>

Documento de configuração do stdin

cat <FILE> | dsc config test [Options] --file -

Documento de configuração do arquivo com parâmetros do stdin

cat <PARAMETERS_FILE> | dsc config --parameters-file - test [Options] --file <FILE>

Documento de configuração da string de opção com parâmetros do stdin

cat <PARAMETERS_FILE> | dsc config --parameters-file - test [Options] --input <INPUT>

Descrição

O test subcomando verifica se as instâncias de recurso em um documento de configuração estão no estado desejado. Quando esse comando é executado, o DSC valida o documento de configuração antes de invocar a operação de teste para cada instância de recurso definida no documento.

O documento de configuração deve ser passado para este comando como JSON ou YAML com a --input opção or --file .

Exemplos

Exemplo 1 - Teste se as instâncias de recursos de uma configuração estão no estado desejado

O comando retorna o status, o estado desejado, o estado real e as propriedades diferentes para as instâncias de recursos definidas no documento de configuração salvo como example.dsc.config.yaml. Ele passa o documento de configuração para o comando do stdin usando a --file opção.

# example.dsc.config.yaml
$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
resources:
- name: Windows only
  type: Microsoft.DSC/Assertion
  properties:
    $schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
    resources:
    - name: os
      type: Microsoft/OSInfo
      properties:
        family: Windows
- name: Current user registry example
  type: Microsoft.Windows/Registry
  properties:
    keyPath: HKCU\example
    _exist: true
  dependsOn:
    - "[resourceId('Microsoft.DSC/Assertion', 'Windows only')"

cat ./example.dsc.config.yaml | dsc config test --file -

Exemplo 2 - Passando um arquivo para ler como o documento de configuração

O comando usa a --file opção para validar a configuração definida no example.dsc.config.yaml arquivo.

dsc config test --file ./example.dsc.config.yaml

Exemplo 3 - Passando um documento de configuração como uma variável

O comando usa a --input opção para validar a configuração armazenada na $desired variável.

dsc config test --input $desired

Opções

-i, --entrada

Especifica o documento de configuração para o qual validar o estado.

O documento deve ser uma cadeia de caracteres contendo um objeto JSON ou YAML. O DSC valida o documento em relação ao esquema do documento de configuração. Se a validação falhar, o DSC gerará um erro.

Esta opção exclui-se mutuamente com a --file opção.

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

-f, --ficheiro

Define o caminho para um documento de configuração para o qual validar o estado.

O arquivo especificado deve conter um documento de configuração como um objeto JSON ou YAML. O 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, o DSC gerará um erro.

Você também pode usar essa opção para passar um documento de configuração do stdin, conforme mostrado no Exemplo 1.

Esta opção exclui-se mutuamente com a --input opção.

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

-o, --formato de saída

A --output-format opção controla qual formato o DSC usa para os dados retornados pelo comando. Os formatos disponíveis são:

• json para emitir os dados como uma linha JSON.
• pretty-json para emitir os dados como JSON com novas linhas, recuo e espaços para legibilidade.
• yaml para emitir os dados como YAML.

O formato de saída padrão depende se o DSC deteta que a saída está sendo redirecionada ou capturada como uma variável:

• Se o comando não estiver sendo redirecionado ou capturado, o DSC exibirá a saída como o yaml formato no console.
• Se a saída do comando for redirecionada ou capturada, o DSC emitirá os dados como o json formato para stdout.

Quando você usa essa opção, o DSC usa o formato especificado, independentemente de o comando estar sendo redirecionado ou capturado.

Quando o comando não é redirecionado ou capturado, a saída no console é formatada para melhorar a legibilidade. Quando o comando não é redirecionado ou capturado, a saída inclui sequências de terminal para formatação.

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

-h, --ajuda

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

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

Resultado

Esse comando retorna dados formatados que incluem se a operação ou quaisquer recursos geraram erros, a coleta de mensagens emitidas durante a operação e os resultados da operação de teste para cada instância. Para obter mais informações, consulte dsc config test result schema.

Para obter mais informações sobre a formatação dos dados de saída, consulte a opção --output-format.