Opções de configuração do YAML para personalizar as tarefas de compilação

Artigo
01/09/2023

Nota

A partir de 31 de dezembro de 2022, a extensão Microsoft Security Code Analysis (MSCA) será desativada. MSCA é substituído pela extensão Microsoft Security DevOps Azure DevOps. Siga as instruções em Configurar para instalar e configurar a extensão.

Este artigo lista todas as opções de configuração do YAML disponíveis em cada uma das tarefas de compilação. O artigo começa com as tarefas para ferramentas de análise de código de segurança. Termina com as tarefas de pós-processamento.

Tarefa do Anti-Malware Scanner

Tipo de entrada	Tipo	Aplicável	Obrigatório	Valor padrão	Opções (para listas de opções)	Descrição
Tipo de entrada	lista de opções	sempre	True	Básica	Básico, Personalizado
Tipo de varredura	lista de opções	InputType = Básico	True	Verificação personalizada	CustomScan, FullSystemScan, QuickScan, YourConfiguredScan	O tipo de verificação a ser usado para a verificação AntiMalware.
FileDirPath	filePath	ScanType = Verificação personalizada	True	$(Build.StagingDirectory)		Indica o arquivo ou diretório a ser verificado.
DisableRemediation	boolean	ScanType = Verificação personalizada	False	verdadeiro		Quando marcada: 1) As exclusões de arquivo são ignoradas. 2) Os arquivos são digitalizados. 3) As ações não são aplicadas após a deteção. 4) As entradas do log de eventos não são gravadas após a deteção. 5) As deteções da verificação personalizada não são exibidas na interface do usuário. 6) A saída do console mostrará a lista de deteções da verificação personalizada.
BootSectorScan	boolean	ScanType = Verificação personalizada	False	false		Se estiver marcada, permite a verificação do setor de inicialização.
Argumentos	string	InputType = Personalizado	True	-Scan -ScanType 3 -DisableRemediation -File $(Build.StagingDirectory)		Os argumentos de linha de comando, onde o argumento para -File é um caminho absoluto ou um caminho relativo para o $(Build.StagingDirectory) predefinido em seu agente de compilação. Nota: Se você não fornecer um argumento para -File como o último argumento, o padrão será $(Build.StagingDirectory). Você também pode fornecer seus próprios argumentos permitidos pela ferramenta MpCmdRun.exe. Para obter mais detalhes sobre os argumentos de linha de comando para esta ferramenta, digite -h ou -? no campo Argumentos e execute a tarefa de compilação.
Serviços Habilitados	boolean	sempre	True	false		Se estiver marcada, tentará ativar os serviços necessários para o Windows Update caso estejam desativados. NOTA: Certifique-se de que a política de grupo não desativa os serviços e que a conta em que esta compilação está a ser executada tem privilégios de administrador.
SupportLogOnError	boolean	sempre	True	false		Se estiver marcado, ele coletará os arquivos de suporte para diagnóstico quando ocorrer um erro. Este processo pode demorar vários minutos. NOTA: Certifique-se de que a conta em que esta compilação está a ser executada tem privilégios de administrador.
TreatSignatureUpdateFailureAs	lista de opções	sempre	True	Aviso	Erro, Padrão, Aviso	O nível de log usado se a assinatura não puder ser atualizada em tempo de execução. Quando definido como Erro, uma falha na atualização da assinatura falhará na tarefa de compilação. Observe que é comum que a atualização de assinatura falhe em agentes de compilação hospedados, mesmo que a assinatura possa ser relativamente atual (menos de 3 horas de idade).
AssinaturaFrescura	lista de opções	sempre	True	UpToDate	OneDay, ThreeDays, TwoDays, UpToDate	A idade máxima permitida para a assinatura AntiMalware. Se a assinatura não puder ser atualizada e for mais antiga que esse valor, a tarefa de compilação se comportará de acordo com o valor selecionado no campo Validar idade das assinaturas como . Nota: Se escolher Atualizado, as assinaturas podem ter até 3 horas.
TreatStaleSignatureAs	lista de opções	sempre	True	Erro	Erro, Padrão, Aviso	O nível de log usado se a idade da assinatura for mais antiga do que a idade da assinatura do AntiMalware selecionada. Uma assinatura desatualizada pode ser tratada como um Aviso ou Informativo para continuar com a verificação AntiMalware, mas isso não é recomendado.

Tarefa BinSkim

Tipo de entrada	Tipo	Aplicável	Obrigatório	Valor padrão	Opções (para listas de opções)	Descrição
Tipo de entrada	lista de opções	sempre	True	Básica	Básico, CommandLine
Argumentos	string	InputType = Linha de Comando	True			Argumentos de linha de comando BinSkim padrão para executar. O caminho de saída será removido e substituído. Para obter mais detalhes sobre os argumentos de linha de comando para esta ferramenta, insira ajuda no campo Argumentos e execute a tarefa de compilação.
Function	lista de opções	InputType = Básico	True	analisar	analisar, despejar, exportConfig, exportRules
AnalyzeTarget	filePath	InputType = Básico && Função = analisar	True	$(Build.ArtifactStagingDirectory).dll; $(Build.ArtifactStagingDirectory).exe		Um ou mais especificadores para um arquivo, diretório ou padrão de filtro que resolve para um ou mais binários para análise. (';' lista separada)
AnalyzeSymPath	string	InputType = Básico && Função = analisar	False			Caminho para o arquivo de símbolos do destino.
AnalyzeConfigPath	string	InputType = Básico && Função = analisar	False	default		Caminho para um arquivo de política que será usado para configurar a análise. Passe o valor de 'padrão' para usar as configurações internas.
AnalyzePluginPath	string	InputType = Básico && Função = analisar	False			Caminho para um plug-in que será invocado em relação a todos os destinos no conjunto de análise.
AnalyzeRecurse	boolean	InputType = Básico && Função = analisar	False	verdadeiro		Recorra em subdiretórios ao avaliar argumentos de especificador de arquivo.
AnalisarVerbose	boolean	InputType = Básico && Função = analisar	False	false		Emita saída detalhada. O relatório abrangente resultante foi projetado para fornecer evidências apropriadas para cenários de conformidade.
AnalyzeHashes	boolean	InputType = Básico && Função = analisar	False	false		Saída SHA-256 hash de alvos de análise ao emitir relatórios SARIF.
AnalyzeStatistics	boolean	InputType = Básico && Função = analisar	False	false		Gere tempo e outras estatísticas para a sessão de análise.
AnalyzeEnvironment	boolean	InputType = Básico && Função = analisar	False	false		Registrar detalhes do ambiente da máquina de executar para o arquivo de saída. AVISO: Esta opção registra informações potencialmente confidenciais (como todos os valores de variáveis de ambiente) para qualquer log emitido.
ExportRulesOutputType	lista de opções	InputType = Básico && Função = exportRules	False	SARIF	SARIF, SonarQube	O tipo de arquivo descritor de regras a ser produzido. Isso será incluído na pasta BinSkim logs publicada pela tarefa de compilação Publish Security Analysis Logs.
DumpTarget	filePath	InputType = Básico && Função = dump	True	$(Build.ArtifactStagingDirectory)		Um ou mais especificadores para um arquivo, diretório ou padrão de filtro que resolve para um ou mais binários para análise. (';' lista separada)
DumpRecurse	boolean	InputType = Básico && Função = dump	False	verdadeiro		Recorra em subdiretórios ao avaliar argumentos de especificador de arquivo.
DumpVerbose	boolean	InputType = Básico && Função = dump	False	verdadeiro		Emita saída detalhada. O relatório abrangente resultante foi projetado para fornecer evidências apropriadas para cenários de conformidade.
toolVersion	lista de opções	sempre	False	Mais Recente	1.5.0, Mais recente, LatestPreRelease	A versão da ferramenta a ser executada.

Tarefa do Verificador de Credenciais

Tipo de entrada	Tipo	Aplicável	Obrigatório	Valor padrão	Opções (para listas de opções)	Descrição
outputFormat	lista de opções	sempre	False	pre	csv, pré, tsv	O formato de saída do arquivo de resultados do Credential Scanner.
toolVersion	lista de opções	sempre	False	Mais Recente	1.27.7, Mais recente, LatestPreRelease	A versão da ferramenta a ser executada.
scanFolder	filePath	sempre	False	$(Build.SourcesDirectory)		A pasta em seu repositório para verificar se há credenciais.
pesquisadoresFileType	lista de opções	sempre	False	Predefinido	Personalizado, Padrão, DefaultAndCustom	Opções para localizar o arquivo de pesquisa usado para digitalização.
pesquisadoresArquivo	filePath	searchersFileType == Custom OR searchersFileType == DefaultAndCustom	False			O arquivo de configuração dos pesquisadores do Credential Scanner de verificações a serem executadas. Vários valores podem ser incluídos e usados fornecendo uma lista separada por vírgulas de caminhos para arquivos de pesquisa do Credential Scanner.
supressõesArquivo	filePath	sempre	False			O arquivo de supressões do Credential Scanner a ser usado para suprimir problemas no log de saída.
suppressAsError	boolean	sempre	False	false		As correspondências suprimidas serão enviadas para o arquivo de saída [-O]-matches. [-f] em vez do arquivo de saída suprimido padrão [-O]-suprimido. [-f]. (O padrão é 'False')
verboseOutput	boolean	sempre	False	false		Saída de informações detalhadas.
batchSize	string	sempre	False			O número de threads simultâneos usados para executar scanners de credenciais em paralelo. (Padrão para 20) O valor deve estar dentro do intervalo de 1-2147483647.
regexMatchTimeoutInSeconds	string	sempre	False			A quantidade de tempo, em segundos, para tentar uma correspondência de pesquisador antes de abandonar a verificação. Adiciona `-Co RegexMatchTimeoutInSeconds=<Value>` à linha de comando.
fileScanReadBufferSize	string	sempre	False			Tamanho do buffer durante a leitura de conteúdo em bytes. (O padrão é 524288) Adiciona `-Co FileScanReadBufferSize=<Value>` à linha de comando.
maxFileScanReadBytes	string	sempre	False			Número máximo de bytes para ler de um determinado arquivo durante a análise de conteúdo. (O padrão é 104857600) Adiciona `-Co MaxFileScanReadBytes=<Value>` à linha de comando.

Tarefa Roslyn Analyzers

Tipo de entrada	Tipo	Aplicável	Obrigatório	Valor padrão	Opções (para listas de opções)	Descrição
userProvideBuildInfo	lista de opções	sempre	True	auto	auto, msBuildInfo	Opções para um usuário fornecer a versão do MSBuild, a arquitetura do MSBuild e a linha de comando de compilação para análise Roslyn. Se Auto estiver selecionado, essa tarefa recuperará as informações de compilação das tarefas anteriores do MSBuild, VSBuild e/ou .NET Core (para compilação) no mesmo pipeline.
msBuildVersion	lista de opções	userProvideBuildInfo == msBuildInfo	True	16.0	15.0, 16.0	A versão do MSBuild.
msBuildArchitecture	lista de opções	userProvideBuildInfo == msBuildInfo	True	x86	DotNetCore, x64, x86	A arquitetura MSBuild. Nota: Se a linha de comando build chamar dotnet.exe compilação, escolha a opção Via .NET Core .
msBuildCommandline	string	userProvideBuildInfo == msBuildInfo	True			A linha de comando de compilação completa para compilar sua solução ou projetos. Notas: A linha de comando deve começar com um caminho completo para MSBuild.exe ou dotnet.exe. O comando será executado com $(Build.SourcesDirectory) como o diretório de trabalho.
rulesetName	lista de opções	sempre	False	Recomendado	Personalizado, Nenhum, Recomendado, Obrigatório	Um conjunto de regras nomeado a ser usado. Se `Ruleset Configured In Your Visual Studio Project File(s)` for escolhido, o conjunto de regras pré-configurado no(s) arquivo(s) de projeto VS será usado. Se `Custom` for escolhida, uma opção de caminho de conjunto de regras personalizada pode ser definida.
rulesetVersion	lista de opções	rulesetName == Required OR rulesetName == Recomendado	False	Mais Recente	8.0, 8.1, 8.2, Mais recente, LatestPreRelease	A versão do conjunto de regras SDL escolhido.
customRuleset	string	rulesetName = Personalizado	False			Um caminho acessível para um conjunto de regras a ser usado. Os caminhos relativos serão normalizados para a raiz do repositório de origem (`$(Build.SourcesDirectory)`). Se o conjunto de regras especificar `Rules` com `Actions` set como `Error`, a tarefa de compilação falhará. Para usar um conjunto de regras que faça isso, verifique `Continue on error` o arquivo `Control Options`da tarefa de compilação.
microsoftAnalyzersVersion	lista de opções	sempre	False	Mais Recente	2.9.3, 2.9.4, 2.9.6, Mais recente, Última versão	A versão do pacote Microsoft.CodeAnalysis.FxCopAnalyzers a ser executado.
suppressionFileForCompilerWarnings	filePath	sempre	False			Um arquivo de supressões para suprimir avisos do compilador C# e VB. Um arquivo de texto simples com cada ID de aviso listava uma linha separada. Para avisos do compilador, especifique apenas a parte numérica do identificador de aviso. Por exemplo, 1018 suprimirá CS1018 e CA1501 suprimirá CA1501. Um caminho de arquivo relativo será anexado à raiz do repositório de origem (`$(Build.SourcesDirectory)`).

Tarefa TSLint

Tipo de entrada	Tipo	Aplicável	Obrigatório	Valor padrão	Opções (para listas de opções)	Descrição
Biblioteca de Regras	lista de opções	sempre	True	Tslint	personalizado, microsoft, tslint	Todos os resultados incluem as regras fornecidas com a versão selecionada do TSLint (Base Only). Base Only - Somente as regras fornecidas com o TSLint. Incluir Regras da Microsoft - Downloads tslint-microsoft-contrib e inclui suas regras para estar disponível para uso na execução TSLint. Escolher esta opção oculta a `Type Checking` caixa de seleção, pois é exigido pelas regras da Microsoft e será usado automaticamente. Ele também exibe o `Microsoft Contribution Version` campo, permitindo que uma versão do `tslint-microsoft-contrib` npm seja selecionada. Incluir regras personalizadas - Reexibe o `Rules Directory` campo, que aceita um caminho acessível para um diretório de regras TSLint a ser disponibilizado para uso na execução TSLint. Nota: O valor padrão foi alterado para tslint, pois muitos usuários tiveram problemas para configurar o conjunto de regras da Microsoft. Para configuração de versão específica, consulte tslint-microsoft-contrib no GitHub.
Diretório de Regras	string	RuleLibrary == personalizado	True			Um diretório acessível contendo regras TSLint adicionais para estar disponível para uso na execução TSLint.
Conjunto de regras	lista de opções	RuleLibrary != microsoft	True	tsrecomendado	personalizado, tslatest, tsrecommended	Define as regras a serem executadas em arquivos TypeScript. tslint:latest - Estende-se `tslint:recommended` e é continuamente atualizado para incluir a configuração para as regras mais recentes em cada versão TSLint. O uso dessa configuração pode introduzir alterações significativas em versões secundárias à medida que novas regras são ativadas, o que causa falhas no seu código. Quando o TSLint atingir um aumento de versão principal, `tslint:recommended` será atualizado para ser idêntico ao `tslint:latest`. tslint:recommended - Um conjunto estável e um pouco opinativo de regras que o TSLint incentiva para a programação geral do TypeScript. Esta configuração segue `semver`, portanto, não terá alterações significativas em versões menores ou de patches.
Conjunto de regrasMicrosoft	lista de opções	Biblioteca de Regras == microsoft	True	mssdlrequired	personalizado, msrecommended, mssdlrecommended, mssdlrequired, tslatest, tsrecommended	Define as regras a serem executadas em arquivos TypeScript. microsoft:sdl-required - Execute todas as verificações disponíveis fornecidas pelo tslint e as regras tslint-microsoft-contrib que satisfaçam as políticas SDL (Security Development Lifecycle – ciclo de vida do desenvolvimento de segurança) necessárias. microsoft:sdl-recommended Execute todas as verificações disponíveis fornecidas pelo tslint e as regras tslint-microsoft-contrib que satisfaçam as políticas SDL (Security Development Lifecycle – ciclo de vida do desenvolvimento de segurança) necessárias e recomendadas. - microsoft:recommended Todas as verificações recomendadas pelos criadores das regras tslint-microsoft-contrib. Isto inclui controlos de segurança e não relacionados com segurança. tslint:latest - Estende-se `tslint:recommended` e é continuamente atualizado para incluir a configuração para as regras mais recentes em cada versão TSLint. O uso dessa configuração pode introduzir alterações significativas em versões menores, à medida que novas regras são ativadas, o que causa falhas no seu código. Quando o TSLint atingir um aumento de versão principal, `tslint:recommended` será atualizado para ser idêntico ao `tslint:latest`. tslint:recommended - Um conjunto estável e um pouco opinativo de regras que o TSLint incentiva para a programação geral do TypeScript. Esta configuração segue `semver`, portanto, não terá alterações significativas em versões menores ou de patches.
RulesetFile	string	Conjunto de regras == personalizado OR RulesetMicrosoft == personalizado	True			Um arquivo de configuração especificando quais regras executar. O caminho para a configuração será adicionado como o caminho para regras personalizadas.
FileSelectionType	lista de opções	sempre	True	fileGlob	fileGlob, projectFile
Ficheiros	string	FileSelectionType == fileGlob	True	.ts		Um glob de arquivo que determina qual(is) arquivo(s) processar. Os caminhos são relativos ao `Build.SourcesDirectory` valor. A biblioteca de contribuição da Microsoft requer o uso de um arquivo de projeto. Se você estiver usando a biblioteca de contribuição da Microsoft com a `File Glob Pattern` opção, um arquivo de projeto será gerado para você.
ECMAScriptVersion	lista de opções	FileSelectionType == fileGlob && RuleLibrary == microsoft	True	ES3	ES2015, ES2016, ES2017, ES3, ES5, ES6, ESNext	A versão de destino do ECMAScript configurada com o compilador TypeScript. Ao usar um arquivo de projeto, este é o campo compilerOptions.target do seu arquivo de tsconfig.json TypeScript.
Project	string	FileSelectionType == projectFile	True			Caminho para um arquivo tsconfig.json que especifica arquivos TypeScript nos quais executar o TSLint. Os caminhos são relativos ao `Build.SourcesDirectory` valor.
TypeCheck	boolean	RuleLibrary != microsoft && FileSelectionType == projectFile	False	verdadeiro		Habilita o verificador de tipos ao executar regras de forro.
ExcludeFiles	string	sempre	False			Um glob que indica arquivos a serem excluídos do linting. Os caminhos são relativos ao `Build.SourcesDirectory` valor. Vários valores podem ser especificados separados por ponto-e-vírgula.
Formato de saída	lista de opções	sempre	True	json	checkstyle, codeFrame, filesList, json, msbuild, pmd, prosa, estiloso, detalhado, vso	O formatador a ser usado para gerar saída. Observe que o formato JSON é compatível com Post Analysis.
NodeMemory	string	sempre	False			Uma quantidade explícita de memória em MBs para alocar ao nó para executar o TSLint. Exemplo: 8000 Mapeia para a opção CLI para o `--max_old_space=<value>` nó, que é um `v8 option`arquivo .
Versão da ferramenta	lista de opções	RuleLibrary != microsoft	True	mais recente	4.0.0, 4.0.1, 4.0.2, 4.1.0, 4.1.1, 4.2.0, 4.3.0, 4.3.1, 4.4.0, 4.4.1, 4.4.2, 4.5.0, 4.5.1, 5.0.0, 5.1.0, 5.2.0, 5.3.0, 5.3.2, 5.4.0, 5.4.1, 5.4.2, 5.4.3, 5.5.0, mais recente	A versão do TSLint para baixar e executar.
TypeScriptVersion	lista de opções	sempre	True	mais recente	0.8.0, 0.8.1, 0.8.2, 0.8.3, 0.9.0, 0.9.1, 0.9.5, 0.9.7, 1.0.0, 1.0.1, 1.3.0, 1.4.1, 1.5.3, 1.6.2, 1.7.3, 1.7.5, 1.8.0, 1.8.10, 1.8.2, 1.8.5, 1.8.6, 1.8.7, 1.8.9, 1.9.0, 2.0.0, 2.0.10, 2.0.2, 2.0.3, 2.0.6, 2.0.7, 2.0.8, 2.0.9, 2.1.1, 2.1.4, 2.1.5, 2.1.6, 2.2.0, 2.2.1, personalizado, mais recente	A versão do TypeScript para baixar e usar. Nota: Esta precisa ser a mesma versão do TypeScript que é usada para compilar seu código.
TypeScriptVersionCustom	string	TypeScriptVersion == personalizado	True	mais recente		A versão do TypeScript para baixar e usar. Nota: Esta precisa ser a mesma versão do TypeScript que é usada para compilar seu código.
MicrosoftContribVersion	lista de opções	Biblioteca de Regras == microsoft		mais recente	4.0.0, 4.0.1, 5.0.0, 5.0.1, mais recente	A versão do tslint-microsoft-contrib (Regras SDL) para baixar e usar. Nota: Será escolhida a versão do tslint que seja compatível com a versão escolhida para tslint-microsoft-contrib. As atualizações para tslint-microsoft-contrib serão limitadas por esta tarefa de compilação, até que um período de teste possa ocorrer.

Tarefa Publicar Logs de Análise de Segurança

Tipo de entrada	Tipo	Aplicável	Obrigatório	Valor padrão	Opções (para listas de opções)	Descrição
Nome do artefato	string	sempre	True	CodeAnalysisLogs		O nome do artefato a ser criado.
Tipo de artefato	lista de opções	sempre	True	Contentor	Contêiner, FilePath	O tipo de artefato a ser criado.
TargetPath	string	ArtifactType = FilePath	False	\my\share$(Build.DefinitionName) $(Build.BuildNumber)		O compartilhamento de arquivos para o qual copiar os arquivos
AllTools	boolean	sempre	True	verdadeiro		Publique os resultados gerados por todas as tarefas de compilação das Ferramentas de Desenvolvimento Seguro.
AntiMalware	boolean	AllTools = falso	True	verdadeiro		Publique os resultados gerados pelas tarefas de compilação do AntiMalware.
BinSkim	boolean	AllTools = falso	True	verdadeiro		Publique os resultados gerados pelas tarefas de compilação BinSkim.
CredScan	boolean	AllTools = falso	True	verdadeiro		Publique os resultados gerados pelas tarefas de compilação do Credential Scanner.
RoslynAnalyzers	boolean	AllTools = falso	True	false		Publique os resultados gerados pelas tarefas de construção do Roslyn Analyzers.
TSLint	boolean	AllTools = falso	True	verdadeiro		Publique os resultados gerados pelas tarefas de compilação do TSLint. Observe que apenas os logs TSLint no formato JSON são suportados para relatórios. Se você escolheu um formato diferente, atualize sua tarefa de compilação TSLint de acordo.
ToolLogsNotFoundAction	lista de opções	sempre	True	Standard	Erro, Nenhum, Padrão, Aviso	A ação a ser executada quando os logs de uma ferramenta selecionada (ou qualquer ferramenta se Todas as Ferramentas estiver marcada) não forem encontrados, o que implica que a ferramenta não foi executada. Opções: Nenhum: A mensagem é gravada no fluxo de saída detalhado acessível somente definindo a variável VSTS system.debug como true. Padrão: (Padrão) Grava uma mensagem de saída padrão informando que não foram encontrados logs para a ferramenta. Aviso: Escreve uma mensagem de aviso amarela informando que não foram encontrados logs para a ferramenta, que aparece na página de resumo da compilação como um aviso. Erro: Grava uma mensagem de erro vermelha e lança uma exceção, quebrando a compilação. Use esta opção para garantir com opções de ferramentas individuais para garantir quais ferramentas foram executadas.

Tarefa Relatório de Segurança

Tipo de entrada	Tipo	Aplicável	Obrigatório	Valor padrão	Opções (para listas de opções)	Descrição
VstsConsole	boolean	sempre	False	verdadeiro		Escreva os resultados no Console de Pipeline.
TsvFile	boolean	sempre	False	verdadeiro		Gere um arquivo tsv (valores separados por tabulação) com uma linha por resultado encontrado e guias separando informações para o resultado.
HtmlFile	boolean	sempre	False	verdadeiro		Gere um arquivo de relatório html.
AllTools	boolean	sempre	True	false		Relatar os resultados gerados por todas as tarefas de compilação do Secure Development Tools.
BinSkim	boolean	AllTools = falso	True	false		Relatar resultados gerados por tarefas de construção BinSkim.
BinSkimBreakOn	lista de opções	AllTools = verdadeiro OU BinSkim = verdadeiro	True	Erro	Erro, WarningAbove	O nível de resultados a comunicar.
CredScan	boolean	AllTools = falso	True	false		Relatar resultados gerados por tarefas de compilação do Credential Scanner.
RoslynAnalyzers	boolean	AllTools = falso	True	false		Relatar os resultados gerados pelas tarefas de compilação do Roslyn Analyzer.
RoslynAnalyzersBreakOn	lista de opções	AllTools = true OU RoslynAnalyzers = true	True	Erro	Erro, WarningAbove	O nível de resultados a comunicar.
TSLint	boolean	AllTools = falso	True	false		Relatar resultados gerados por tarefas de compilação TSLint. Observe que apenas os logs TSLint no formato JSON são suportados para relatórios. Se você escolheu um formato diferente, atualize sua tarefa de compilação TSLint de acordo.
TSLintBreakOn	lista de opções	AllTools = true OU TSLint = true	True	Erro	Erro, WarningAbove	O nível de resultados a comunicar.
ToolLogsNotFoundAction	lista de opções	sempre	True	Standard	Erro, Nenhum, Padrão, Aviso	A ação a ser executada quando os logs de uma ferramenta selecionada (ou qualquer ferramenta se Todas as Ferramentas estiver marcada) não forem encontrados, o que implica que a ferramenta não foi executada. Opções: Nenhum: A mensagem é gravada no fluxo de saída detalhado acessível somente definindo a variável VSTS system.debug como true. Padrão: (Padrão) Grava uma mensagem de saída padrão informando que não foram encontrados logs para a ferramenta. Aviso: Escreve uma mensagem de aviso amarela informando que não foram encontrados logs para a ferramenta, que aparece na página de resumo da compilação como um aviso. Erro: Grava uma mensagem de erro vermelha e lança uma exceção, quebrando a compilação. Use esta opção para garantir com opções de ferramentas individuais para garantir quais ferramentas foram executadas.
CustomLogsFolder	string	sempre	False			A pasta base onde os logs da ferramenta de análise estão localizados; Os arquivos de log individuais estarão em subpastas com o nome de cada ferramenta, sob este caminho.

Tarefa pós-análise

Tipo de entrada	Tipo	Aplicável	Obrigatório	Valor padrão	Opções (para listas de opções)	Descrição
AllTools	boolean	sempre	True	false		Quebre a compilação se algum problema for encontrado por qualquer tarefa de compilação da Análise de Código de Segurança da Microsoft.
BinSkim	boolean	AllTools = falso	True	false		Quebre a compilação se algum problema BinSkim for encontrado, de acordo com a opção Break On que você selecionou.
BinSkimBreakOn	lista de opções	AllTools = verdadeiro OU BinSkim = verdadeiro	True	Erro	Erro, WarningAbove	O nível de problemas para quebrar a compilação.
CredScan	boolean	AllTools = falso	True	false		Quebre a compilação se algum problema do Credential Scanner for encontrado.
RoslynAnalyzers	boolean	AllTools = falso	True	false		Quebre a compilação se algum problema do Roslyn Analyzer for encontrado.
RoslynAnalyzersBreakOn	lista de opções	AllTools = true OU RoslynAnalyzers = true	True	Erro	Erro, WarningAbove	O nível de problemas para quebrar a compilação.
TSLint	boolean	AllTools = falso	True	false		Quebre a compilação se algum problema TSLint for encontrado. Observe que apenas os logs TSLint no formato JSON são suportados para análise de postagem. Se você escolheu um formato diferente, atualize sua tarefa de compilação TSLint de acordo.
TSLintBreakOn	lista de opções	AllTools = true OU TSLint = true	True	Erro	Erro, WarningAbove	O nível de problemas para quebrar a compilação.
VstsConsole	boolean	sempre	False	verdadeiro		Escreva os resultados no Console de Pipeline.
ToolLogsNotFoundAction	lista de opções	sempre	True	Standard	Erro, Nenhum, Padrão, Aviso	A ação a ser executada quando os logs de uma ferramenta selecionada (ou qualquer ferramenta se Todas as Ferramentas estiver marcada) não forem encontrados, o que implica que a ferramenta não foi executada. Opções: Nenhum: A mensagem é gravada no fluxo de saída detalhado acessível somente definindo a variável VSTS system.debug como true. Padrão: (Padrão) Grava uma mensagem de saída padrão informando que não foram encontrados logs para a ferramenta. Aviso: Escreve uma mensagem de aviso amarela informando que não foram encontrados logs para a ferramenta, que aparece na página de resumo da compilação como um aviso. Erro: Grava uma mensagem de erro vermelha e lança uma exceção, quebrando a compilação. Use esta opção para garantir com opções de ferramentas individuais para garantir quais ferramentas foram executadas.

Próximos passos

Se você tiver mais dúvidas sobre a extensão Análise de Código de Segurança e as ferramentas oferecidas, confira nossa página de perguntas frequentes.

Partilhar via