SecAnnotate.exe (средство создания заметок безопасности .NET)SecAnnotate.exe (.NET Security Annotator Tool)

Средство создания заметок безопасности .NET Security Annotator (SecAnnotate.exe) — это приложение командной строки, определяющее части SecurityCritical и SecuritySafeCritical одной или нескольких сборок.The .NET Security Annotator tool (SecAnnotate.exe) is a command-line application that identifies the SecurityCritical and SecuritySafeCritical portions of one or more assemblies.

Расширение Visual Studio Security Annotator обеспечивает графический пользовательский интерфейс для программы SecAnnotate.exe и позволяет запускать эту программу из Visual Studio.A Visual Studio extension, Security Annotator, provides a graphical user interface to SecAnnotate.exe and enables you to run the tool from Visual Studio.

Эта программа автоматически устанавливается вместе с Visual Studio.This tool is automatically installed with Visual Studio. Чтобы применить этот инструмент, воспользуйтесь командной строкой разработчика для Visual Studio (или командной строкой Visual Studio в Windows 7).To run the tool, use the Developer Command Prompt for Visual Studio (or the Visual Studio Command Prompt in Windows 7). Дополнительные сведения см. в разделе Командные строки.For more information, see Command Prompts.

В командной строке введите следующий текст, где параметры описаны в следующем разделе, а сборки состоят из одного имени сборок или нескольких, разделенных пробелами.At the command prompt, type the following, where parameters are described in the following section, and assemblies consist of one or more assembly names separated by blanks:

СинтаксисSyntax

SecAnnotate.exe [parameters] [assemblies]  

ПараметрыParameters

ПараметрOption ОписаниеDescription
/a

илиor

/showstatistics
Показывает статистику использования прозрачности в анализируемых сборках.Shows statistics about the use of transparency in assemblies that are being analyzed.
/d: каталог/d: directory

илиor

/referencedir: каталог/referencedir: directory
Указывает каталог для поиска зависимых сборок во время создания заметок.Specifies a directory to search for dependent assemblies during annotation.
/i

илиor

/includesignatures
Включает данные расширенной подписи в файл отчетов аннотирования.Includes extended signature information in the annotation report file.
/n

илиor

/nogac
Отключает поиск сборок в глобальном кэше сборок, на которые указывают ссылки.Suppresses searching for referenced assemblies in the global assembly cache.
/o: output.xml/o: output.xml

илиor

/out: output.xml/out: output.xml
Указывает выходной файл аннотаций.Specifies the output annotation file.
/p: макс_число_проходов/p: maxpasses

илиor

/maximumpasses: макс_число_проходов/maximumpasses: maxpasses
Задает максимальное число проходов аннотирования, выполняемых для сборок до прекращения создания новых заметок.Specifies the maximum number of annotation passes to make on assemblies before stopping the generation of new annotations.
/q

илиor

/quiet
Задает тихий режим, при котором средство создания заметок безопасности не выводит сообщения о состоянии, а выводит только сведения об ошибке.Specifies quiet mode, in which the annotator does not output status messages; it outputs only error information.
/r: сборка/r: assembly

илиor

/referenceassembly: сборка/referenceassembly: assembly
Включает указанную сборку при разрешении зависимых сборок во время аннотирования.Includes the specified assembly when resolving dependent assemblies during annotation. Ссылается на сборки, получающие приоритет над сборками, которые находятся по пути для ссылок.Reference assemblies are given priority over assemblies that are found in the reference path.
/s: имя_правила/s: rulename

илиor

/suppressrule: имя_правила/suppressrule: rulename
Запрещает выполнение указанного правила прозрачности для входных сборок.Suppresses running the specified transparency rule on the input assemblies.
/t

илиor

/forcetransparent
Включает режим, при котором средство создания заметок безопасности принудительно считает все сборки, не имеющие никаких заметок о прозрачности, полностью прозрачными.Forces the Annotator tool to treat all assemblies that do not have any transparency annotations as if they were entirely transparent.
/t:сборка/t:assembly

илиor

/forcetransparent:сборка/forcetransparent:assembly
Указанная сборка будет считаться прозрачной независимо от текущих заметок на уровне сборки.Force the given assembly to be transparent, regardless of its current assembly-level annotations.
/v

илиor

/verify
Проверяет только правильность заметок сборки, не выполняет несколько проходов для нахождения всех требуемых заметок, если сборка не проверяется.Verifies only that an assembly's annotations are correct; does not attempt to make multiple passes to find all required annotations if the assembly does not verify.
/x

илиor

/verbose
Задает подробный вывод при создании заметок.Specifies verbose output while annotating.
/y: каталог/y: directory

илиor

/symbolpath: каталог/symbolpath: directory
Включает указанный каталог при поиске файлов символов во время аннотирования.Includes the specified directory when searching for symbol files during annotation.

ПримечанияRemarks

Параметры и сборки также могут предоставляться в файле ответов, указанном в командной строке с префиксом в виде знака @ .Parameters and assemblies may also be provided in a response file that is specified on the command line and prefixed with an at sign (@). Каждая строка в файле ответов должна содержать один параметр или имя сборки.Each line in the response file should contain a single parameter or assembly name.

Дополнительные сведения о .NET Security Annotator см. в записи Использование SecAnnotate для анализа сборок на наличие нарушений прозрачности в блоге .NET Security.For more information about the .NET Security Annotator, see the entry Using SecAnnotate to Analyze Your Assemblies for Transparency Violations in the .NET Security blog.

ПримерыExamples