teste de configuração dsc

Sinopse

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

Syntax

Documento de configuração do stdin

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

Documento de configuração da cadeia de caracteres de opção

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

Documento de configuração do arquivo

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

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 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 de caminho .

Exemplos

Exemplo 1 – Testar se as instâncias de recurso 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 recurso definidas no documento de configuração salvo como example.dsc.config.yaml.

# example.dsc.config.yaml
$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
resources:
- name: Windows only
  type: DSC/AssertionGroup
  properties:
    $schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/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
    _ensure: Present
  dependsOn:
    - '[DSC/Assertion]Windows only'

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

Exemplo 2 – Passar um arquivo para ler como o documento de configuração

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

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

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

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

dsc config test --document $desired

Opções

-d, --document

Especifica o documento de configuração para o qual validar o estado. O documento deve ser uma cadeia de caracteres que contém 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.

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 para validar o estado para em vez de canalizar o documento de 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. 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.

Essa opção é mutuamente exclusiva com a opção --document . Quando você usa essa 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 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 uma saída JSON que inclui se a operação ou quaisquer recursos geraram erros, a coleção 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.