SecAnnotate.exe (strumento .NET Security Annotator)

Lo strumento .NET Security Annotator (SecAnnotate.exe) è un'applicazione della riga di comando che identifica le parti SecurityCritical e SecuritySafeCritical di uno o più assembly.

Un'estensione di Visual Studio, Security Annotator, fornisce un'interfaccia utente grafica a SecAnnotate.exe e consente di eseguire lo strumento da Visual Studio.

Questo strumento viene installato automaticamente con Visual Studio e con Windows SDK. Per eseguire lo strumento, si consiglia di utilizzare il prompt dei comandi di Visual Studio o il prompt dei comandi di Windows SDK (shell di CMD). Queste utilità consentono di eseguire facilmente lo strumento, senza dover passare alla cartella di installazione. Per ulteriori informazioni, vedere Prompt dei comandi di Visual Studio e Windows SDK.

• Se si dispone di Visual Studio installato sul computer: nella barra delle applicazioni, fare clic su Start, fare clic su All Programs, fare clic su Visual Studio, fare clic su Visual Studio Tools e quindi su Visual Studio Command Prompt.

  In alternativa

  Se si dispone di Windows SDK installato sul computer: nella barra delle applicazioni, fare clic su Start, fare clic su All Programs, fare clic sulla cartella di Windows SDK e quindi su Command Prompt (o CMD Shell).

• Nel prompt dei comandi, immettere quanto segue, dove i parametri sono descritti nella seguente sezione e gli assembly sono costituiti da uno o più nomi dell'assembly separati da spazi vuoti:

SecAnnotate.exe [parameters] [assemblies]

Parametri

Opzione	Oggetto di descrizione
/a oppure /showstatistics	Mostra statistiche sull'utilizzo di trasparenza negli assembly analizzati.
/d:directory oppure /referencedir:directory	Specifica una directory per cercare assembly dipendenti durante l'annotazione.
/i oppure /includesignatures	Include informazioni estese sulla firma nel file di report delle annotazioni.
/n oppure /nogac	Elimina cercando gli assembly di riferimento nella Global Assembly Cache.
/o:output.xml oppure /out:output.xml	Consente di specificare il file di annotazione dell'output.
/p:maxpasses oppure /maximumpasses:maxpasses	Specifica il numero massimo di passaggi di annotazione da fare sugli assembly prima di interrompere la generazione di nuove annotazioni.
/q oppure /quiet	Specifica una modalità non interattiva, nella quale l'annotatore non restituisce messaggi di stato; restituisce solo informazioni sull'errore.
/r:assembly oppure /referenceassembly:assembly	Include l'assembly specificato in caso di risoluzione di assembly dipendenti durante l'annotazione. Gli assembly di riferimento sono prioritari rispetto agli assembly trovati nel percorso di riferimento.
/s:rulename oppure /suppressrule:rulename	Elimina eseguendo la regola di trasparenza specificata sugli assembly di input.
/t oppure /forcetransparent	Forza lo strumento annotatore a trattare tutti gli assembly che non dispongono di alcuna annotazione della trasparenza come se fossero completamente trasparenti.
/v oppure /verify	Verifica solo che le annotazioni di un assembly siano corrette; non tenta di eseguire più sessioni per trovare tutte le annotazioni obbligatorie se l'assembly non verifica.
/x oppure /verbose	Specifica l'output dettagliato durante l'annotazione.
/y:directory oppure /symbolpath:directory	Include la directory specificata quando effettua la ricerca di file di simboli durante l'annotazione.

Note

Parametri e assembly possono essere forniti anche in un file di risposta specificato sulla riga di comando e possono essere preceduti dal simbolo chiocciola (@). Ogni riga nel file di risposta deve contenere un solo parametro o un nome dell'assembly.

Per ulteriori informazioni su .NET Security Annotator, vedere la voce Using SecAnnotate to Analyze Your Assemblies for Transparency Violations nel blog .NET Security.

Cronologia delle modifiche

Data	Cronologia	Motivo
Aprile 2011	Sono state aggiunte informazioni sull'utilizzo di Visual Studio e dei prompt dei comandi di Windows SDK.	Miglioramento delle informazioni.
Luglio 2010	È stato aggiunto un collegamento a Security Annotator.	Miglioramento delle informazioni.