SecAnnotate.exe (Herramienta Anotador de seguridad de .NET)SecAnnotate.exe (.NET Security Annotator Tool)

La herramienta Anotador de seguridad de .NET (SecAnnotate.exe) es una aplicación de línea de comandos que identifica los elementos SecurityCritical y SecuritySafeCritical de uno o más ensamblados.The .NET Security Annotator tool (SecAnnotate.exe) is a command-line application that identifies the SecurityCritical and SecuritySafeCritical portions of one or more assemblies.

El Anotador de seguridad, que es una extensión de Visual Studio, proporciona una interfaz gráfica de usuario a SecAnnotate.exe y permite ejecutar la herramienta desde 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.

Esta herramienta se instala automáticamente con Visual Studio.This tool is automatically installed with Visual Studio. Para ejecutar la herramienta, use Símbolo del sistema para desarrolladores de Visual Studio (o Símbolo del sistema de Visual Studio en Windows 7).To run the tool, use the Developer Command Prompt for Visual Studio (or the Visual Studio Command Prompt in Windows 7). Para más información, consulte Símbolos del sistema.For more information, see Command Prompts.

En el símbolo del sistema, escriba lo siguiente (los valores de parameters se describen en la sección siguiente y assemblies se compone de uno o varios nombres de ensamblado separados por espacios en blanco):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:

SintaxisSyntax

SecAnnotate.exe [parameters] [assemblies]  

ParámetrosParameters

OpciónOption DescripciónDescription
/a

oor

/showstatistics
Muestra estadísticas sobre el uso de transparencia en los ensamblados que se van a analizar.Shows statistics about the use of transparency in assemblies that are being analyzed.
/d: directory/d: directory

oor

/referencedir: directory/referencedir: directory
Especifica el directorio en el que buscar los ensamblados dependientes durante la anotación.Specifies a directory to search for dependent assemblies during annotation.
/i

oor

/includesignatures
Incluye información de signatura ampliada en el archivo de informe de anotación.Includes extended signature information in the annotation report file.
/n

oor

/nogac
Suprime la búsqueda de los ensamblados a los que se hace referencia en la caché global de ensamblados.Suppresses searching for referenced assemblies in the global assembly cache.
/o: output.xml/o: output.xml

oor

/out: output.xml/out: output.xml
Especifica el archivo de anotación de salida.Specifies the output annotation file.
/p: maxpasses/p: maxpasses

oor

/maximumpasses: maxpasses/maximumpasses: maxpasses
Especifica el número máximo de pasos de anotación que se realizan en los ensamblados antes de detener la generación de nuevas anotaciones.Specifies the maximum number of annotation passes to make on assemblies before stopping the generation of new annotations.
/q

oor

/quiet
Especifica el modo silencioso, en el que el anotador no genera mensajes de salida de estado; solo genera información de error.Specifies quiet mode, in which the annotator does not output status messages; it outputs only error information.
/r: assembly/r: assembly

oor

/referenceassembly: assembly/referenceassembly: assembly
Incluye el ensamblado especificado al resolver ensamblados dependientes durante la anotación.Includes the specified assembly when resolving dependent assemblies during annotation. Los ensamblados de referencia tienen prioridad sobre los ensamblados que se encuentran en la ruta de acceso de referencia.Reference assemblies are given priority over assemblies that are found in the reference path.
/s: rulename/s: rulename

oor

/suppressrule: rulename/suppressrule: rulename
Suprime la ejecución de la regla de transparencia especificada en los ensamblados de entrada.Suppresses running the specified transparency rule on the input assemblies.
/t

oor

/forcetransparent
Fuerza a la herramienta Anotador a tratar todos los ensamblados que no tienen ninguna anotación de transparencia como si fueran completamente transparentes.Forces the Annotator tool to treat all assemblies that do not have any transparency annotations as if they were entirely transparent.
/t:assembly/t:assembly

oor

/forcetransparent:assembly/forcetransparent:assembly
Fuerza al ensamblado proporcionado a que sea transparente, independientemente de las anotaciones de nivel de ensamblado actuales.Force the given assembly to be transparent, regardless of its current assembly-level annotations.
/v

oor

/verify
Comprueba únicamente que las anotaciones de un ensamblado sean correctas, pero no intenta ejecutar varios pasos para buscar todas las anotaciones necesarias si el ensamblado no supera la comprobación.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

oor

/verbose
Especifica resultados detallados al anotar.Specifies verbose output while annotating.
/y: directory/y: directory

oor

/symbolpath: directory/symbolpath: directory
Incluye el directorio especificado al buscar archivos de símbolos durante la anotación.Includes the specified directory when searching for symbol files during annotation.

ComentariosRemarks

Los parámetros y ensamblados también se pueden proporcionar en un archivo de respuesta que se especifica en la línea de comandos y lleva el prefijo de una arroba (@).Parameters and assemblies may also be provided in a response file that is specified on the command line and prefixed with an at sign (@). Cada línea del archivo de respuesta debe contener un nombre de ensamblado o parámetro único.Each line in the response file should contain a single parameter or assembly name.

Para obtener más información sobre el Anotador de seguridad de .NET, vea la entrada sobre cómo usar SecAnnotate para analizar los ensamblados y detectar infracciones de transparencia en el blog de seguridad de .NET.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.

EjemplosExamples