{"meta":{"title":"diagnostic add","intro":"[Experimental] [Conexão] Adicione uma informação de diagnóstico.","product":"Qualidade de segurança e código","breadcrumbs":[{"href":"/pt/code-security","title":"Qualidade de segurança e código"},{"href":"/pt/code-security/reference","title":"Referência"},{"href":"/pt/code-security/reference/code-scanning","title":"Varredura de código"},{"href":"/pt/code-security/reference/code-scanning/codeql","title":"CodeQL"},{"href":"/pt/code-security/reference/code-scanning/codeql/codeql-cli-manual","title":"Manual da CLI do CodeQL"},{"href":"/pt/code-security/reference/code-scanning/codeql/codeql-cli-manual/diagnostic-add","title":"diagnostic add"}],"documentType":"article"},"body":"# diagnostic add\n\n[Experimental] [Conexão] Adicione uma informação de diagnóstico.\n\n> [!NOTE]\n> Este conteúdo descreve a versão mais recente do CodeQL CLI. Para obter mais informações sobre essa versão, confira https://github.com/github/codeql-cli-binaries/releases.\n>\n> Para ver os detalhes das opções disponíveis para esse comando em uma versão anterior, execute o comando com a opção <span style=\"white-space: nowrap;\">`--help`</span> no terminal.\n\n## Sinopse\n\n```shell copy\ncodeql diagnostic add (--diagnostic-dir=<diagnosticDir>) --source-id=<id> --source-name=<name> <options>...\n```\n\n## Description\n\n              \\[[Experimental] \\[[Conexão] Adicione uma informação de diagnóstico.\n\nDisponível desde `v2.12.6`.\n\n## Opções\n\n### Opções principais\n\n#### `--markdown-message=<markdownMessage>`\n\nMensagem para o diagnóstico, no formato Markdown em estilo GitHub.\n\n#### `--plaintext-message=<plaintextMessage>`\n\nMensagem para o diagnóstico, em texto sem formatação. Essa opção só deverá ser usada quando preencher uma mensagem markdown com --markdown-message não for prático.\n\n#### `--severity=<severity>`\n\nSeveridade do diagnóstico. Pode ser \"error\", \"warning\" ou \"note\".\n\n#### `--help-link=<helpLinks>`\n\nLinks de ajuda relevantes para o diagnóstico.\n\n#### `--attributes-json=<attributesJson>`\n\nMetadados estruturados relevantes para o diagnóstico.\n\n### Opções que especificam onde salvar as informações de diagnóstico\n\nExatamente uma dessas opções precisa ser fornecida.\n\n#### `--diagnostic-dir=<diagnosticDir>`\n\nDiretório ao qual devemos adicionar o diagnóstico.\n\n### Opções que indicam onde a mensagem de diagnóstico pode ser exibida\n\n#### `--ready-for-status-page`\n\nIndicam que o diagnóstico é adequado para exibição na página status.\n\n#### `--ready-for-cli-summary-table`\n\nIndicam que o diagnóstico é adequado para exibição na tabela de resumo diagnóstico impressa por comandos como `database analyze`.\n\n### Opções que descrevem a origem do diagnóstico\n\n#### `--source-id=<id>`\n\n              \\[Obrigatório] Um identificador para a origem deste diagnóstico.\n\n#### `--source-name=<name>`\n\n              \\[Obrigatório] Uma descrição em linguagem acessível ao ser humano da origem deste diagnóstico.\n\n#### `--extractor-name=<extractorName>`\n\nO nome do extrator CodeQL, se esse diagnóstico foi produzido por um extrator CodeQL.\n\n### Opções que descrevem o local do diagnóstico\n\n#### `--file-path=<file>`\n\nO caminho do arquivo ao qual o diagnóstico se aplica, em relação à raiz de origem.\n\n#### `--start-line=<startLine>`\n\nO número de linha baseado em 1 (inclusive) em que o local do diagnóstico é iniciado.\n\n#### `--start-column=<startColumn>`\n\nO número de coluna baseado em 1 (inclusive) em que o local do diagnóstico é iniciado.\n\n#### `--end-line=<endLine>`\n\nO número de linha baseado em 1 (inclusive) em que o local do diagnóstico termina.\n\n#### `--end-column=<endColumn>`\n\nO número de coluna baseado em 1 (inclusive) em que o local do diagnóstico termina.\n\n### Opções comuns\n\n#### `-h, --help`\n\nMostre este texto de ajuda.\n\n#### `-J=<opt>`\n\n              \\[Avançado] Dê opções à JVM que executa o comando.\n\n(Use-a com cautela, pois as opções que contêm espaços não serão tratadas corretamente.)\n\n#### `-v, --verbose`\n\nAumente incrementalmente o número de mensagens de progresso impressas.\n\n#### `-q, --quiet`\n\nDiminua incrementalmente o número de mensagens de progresso impressas.\n\n#### `--verbosity=<level>`\n\n              \\[Avançado] Defina explicitamente o nível de detalhamento para um dos seguintes: erros, avisos, progresso, progresso+, progresso++, progresso+++. Substitui `-v` e `-q`.\n\n#### `--logdir=<dir>`\n\n              \\[Avançado] Grava registros detalhados em um ou mais arquivos no diretório especificado, com nomes gerados que incluem carimbos de data/hora e o nome do subcomando em execução.\n\n(Para gravar um arquivo de log com um nome sobre o qual você tem controle completo, forneça `--log-to-stderr` e redirecione stderr conforme desejado.)\n\n#### `--common-caches=<dir>`\n\n              \\[Avançado] Controla a localização dos dados em cache no disco que persistirão entre várias execuções da CLI, como pacotes QL baixados e planos de consulta compilados. Se não for definido explicitamente, o padrão corresponde a um diretório intitulado `.codeql` no diretório inicial do usuário; que será criado se ainda não existir.\n\nDisponível desde `v2.15.2`."}