dsc

Synopsis

Aplique configuração ou invoque recursos específicos para gerir componentes de software.

Sintaxe

dsc [Options] <COMMAND>

Comandos

Concluído

O completer comando devolve um script de shell que, quando executado, regista completações para o shell dado. Para mais informações, consulte dsc completer.

config

O config comando gere um documento de Configuração DSC. Você pode usá-lo para:

  • Vê o estado atual da configuração.
  • Teste se uma configuração está no estado desejado.
  • Defina uma configuração para o estado desejado.

Para mais informações, veja configuração dsc.

recurso

O resource comando gere um Recurso DSC. Você pode usá-lo para:

  • Liste os recursos disponíveis.
  • Obtenha o esquema JSON das instâncias de um recurso.
  • Obtenha o estado atual de uma instância de recurso.
  • Teste se uma instância de recurso está no estado desejado.
  • Defina uma instância de recurso para o estado desejado.

Para mais informações, consulte o recurso dsc

esquema

O schema comando devolve o esquema JSON para um tipo específico de DSC. Para mais informações, veja esquema dsc.

ajuda

O help comando devolve informação de ajuda para dsc, um comando ou um subcomando.

Para obter ajuda para um comando ou subcomando, use a sintaxe:

dsc help <COMMAND> [<SUBCOMMAND>]

Por exemplo, dsc help config recebe ajuda para o config subcomando. dsc help config set Recebe ajuda para o config set subcomando.

Também pode usar a opção --help num comando para mostrar a informação de ajuda. Por exemplo, dsc config --help ou dsc config set --help.

Opções

-l, --nível de traço

Define o nível mínimo de mensagem que o DSC deve emitir durante uma operação. As mensagens no DSC são categorizadas pelo seu nível.

A lista seguinte mostra os níveis de mensagem válidos do nível mais alto para o mais baixo. Quando esta opção está definida para qualquer valor na lista, o DSC emite mensagens nesse nível e superior.

  • error
  • warn (padrão)
  • info
  • debug
  • trace

Warning

A trace saída do nível emite toda a entrada/saída JSON que o DSC processa durante a execução. O DSC não desinfeta o JSON antes de o emitir. Este nível de rastreamento destina-se apenas ao uso dos desenvolvedores. Nunca redirecione trace a saída de nível para o armazenamento, pois pode conter informação sensível.

Por exemplo, quando o nível logarítmico é debug, o DSC emite mensagens para todos os níveis logarítmicos, exceto trace. Quando o nível de registo é error, o DSC apenas emite mensagens de erro. O DSC ignora todas as mensagens com um nível logarítmic inferior.

Type         : string
Mandatory    : false
DefaultValue : warn
ValidValues  : [error, warn, info, debug, trace]
LongSyntax   : --trace-level <TRACE_LEVEL>
ShortSyntax  : -l <TRACE_LEVEL>

-f, --formato de traço

Define o formato de saída a usar ao emitir mensagens de rastreio em stderr. O DSC suporta os seguintes formatos:

  • default - Emite a mensagem com a coloração da consola ANSI para o carimbo temporal, nível da mensagem e número de linha.
  • plaintext - Mas sem cores de default consola.
  • json - Emite cada mensagem como um objeto JSON comprimido com o carimbo temporal, nível, mensagem e número de linha como propriedades.
Type         : string
Mandatory    : false
DefaultValue : default
ValidValues  : [default, plaintext, json]
LongSyntax   : --trace-format <TRACE_FORMAT>
ShortSyntax  : -f <TRACE_FORMAT>

-p, --progresso-formato

Define o formato de progresso a usar ao emitir mensagens de progresso em stderr. O DSC suporta os seguintes formatos:

  • default - Mostra uma barra de progresso se o DSC detetar que está a ser chamado de forma interativa. Caso contrário, o DSC não mostra qualquer progresso.
  • none - Não mostra progresso.
  • json - Emite progresso como objetos JSON comprimidos com o carimbo temporal, nível, mensagem e número de linha como propriedades.
Type         : string
Mandatory    : false
DefaultValue : default
ValidValues  : [default, none, json]
LongSyntax   : --progress-format <PROGRESS_FORMAT>
ShortSyntax  : -p <PROGRESS_FORMAT>

-V, --versão

Mostra a versão da aplicação. Quando especifica esta opção, a aplicação ignora todas as opções e argumentos, exceto --help, que sobrepõe esta opção.

Type        : boolean
Mandatory   : false
LongSyntax  : --version
ShortSyntax : -V

-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

Variáveis de ambiente

Por defeito, o dsc comando procura manifestos de recursos DSC nas pastas definidas pela PATH variável de ambiente. Se a DSC_RESOURCE_PATH variável de ambiente estiver definida, dsc pesquisa as pastas em DSC_RESOURCE_PATH vez de PATH.

O DSC_RESOURCE_PATH ambiente deve ser uma variável de ambiente que siga as mesmas convenções da PATH variável de ambiente do sistema operativo. Caminhos de pasta separados com ponto e vírgula (;) no Windows e dois pontos (:) noutras plataformas.

Códigos de saída

O dsc comando utiliza códigos de saída semânticos. Cada código de saída representa um resultado diferente para a execução do comando.

Código de saída Meaning
0 O comando foi executado com sucesso, sem quaisquer erros.
1 O comando falhou porque recebeu argumentos inválidos.
2 O comando falhou porque um recurso gerou um erro.
3 O comando falhou porque um valor não podia ser serializado ou desserializado a partir do JSON.
4 O comando falhou porque a entrada para o comando não era válida em YAML ou JSON.
5 O comando falhou porque uma definição de recurso ou valor de instância era inválido contra o seu esquema JSON.
6 O comando foi cancelado por uma interrupção Ctrl+C .

Observações

O DSC espera que as cadeias de entrada usem codificação UTF-8. Quando passar a entrada do stdin ou do caminho para um ficheiro, certifique-se de que a entrada está codificada como UTF-8.

  • Last updated on