-c [csp]

Sets the default cryptographic service provider (CSP) to use for strong name signing. This setting applies to the entire computer. If you do not specify a CSP name, Sn.exe clears the current setting.

-d container

Deletes the specified key container from the strong name CSP.

-D assembly1 assembly2

Verifies that two assemblies differ only by signature. This is often used as a check after an assembly has been re-signed with a different key pair.

-e assembly outfile

Extracts the public key from assembly and stores it in outfile.

-h

Displays command syntax and options for the tool.

-i infile container

Installs the key pair from infile in the specified key container. The key container resides in the strong name CSP.

-k [keysize] outfile

Generates a new RSACryptoServiceProvider key of the specified size and writes it to the specified file. Both a public and private key are written to the file.

If you do not specify a key size, a 1,024-bit key is generated by default if you have the Microsoft enhanced cryptographic provider installed; otherwise, a 512-bit key is generated.

The keysize parameter supports key lengths from 384 bits to 16,384 bits in increments of 8 bits if you have the Microsoft enhanced cryptographic provider installed. It supports key lengths from 384 bits to 512 bits in increments of 8 bits if you have the Microsoft base cryptographic provider installed.

-m [y|n]

Specifies whether key containers are computer-specific, or user-specific. If you specify y, key containers are computer-specific. If you specify n, key containers are user-specific.

If neither y nor n is specified, this option displays the current setting.

-o infile [outfile]

Extracts the public key from the infile and stores it in a .csv file. A comma separates each byte of the public key. This format is useful for hard-coding references to keys as initialized arrays in source code. If you do not specify an outfile, this option places the output on the Clipboard.

Note

This option does not verify that the input is only a public key. If the infile contains a key pair with a private key, the private key is also extracted.

-p infile outfile

Extracts the public key from the key pair in infile and stores it in outfile. This public key can be used to delay-sign an assembly using the /delaysign+ and /keyfile options of the Assembly Linker (Al.exe). When an assembly is delay-signed, only the public key is set at compile time and space is reserved in the file for the signature to be added later, when the private key is known.

-pc container outfile

Extracts the public key from the key pair in container and stores it in outfile.

-Pb [y|n]

Specifies whether the strong-name bypass policy is enforced. If you specify y, strong names for full-trust assemblies are not validated when loaded into a full-trust AppDomain. If you specify n, strong names are validated for correctness, but not for a specific strong name. The StrongNameIdentityPermission has no effect on full-trust assemblies. You must perform your own check for a strong name match.

If neither y nor n is specified, this option displays the current setting. The default is y.

Note

On 64-bit computers, you must set this parameter in both the 32-bit and the 64-bit instances of Sn.exe.

-q[uiet]

Specifies quiet mode; suppresses the display of success messages.

-R[a] assembly infile

Re-signs a previously signed or delay-signed assembly with the key pair in infile.

If -Ra is used, hashes are recomputed for all files in the assembly.

-Rc[a] assembly container

Re-signs a previously signed or delay-signed assembly with the key pair in container.

If -Rca is used, hashes are recomputed for all files in the assembly.

-Rh assembly

Recomputes hashes for all files in the assembly.

-t[p] infile

Displays the token for the public key stored in infile. The contents of infile must be a public key previously generated from a key pair file using -p. Do not use the -t[p] option to extract the token directly from a key pair file.

Sn.exe computes the token by using a hash function from the public key. To save space, the common language runtime stores public key tokens in the manifest as part of a reference to another assembly when it records a dependency to an assembly that has a strong name. The -tp option displays the public key in addition to the token.

Note that this option does not verify the assembly signature and should not be used to make trust decisions. This option only displays the raw public key token data.

-T[p] assembly

Displays the public key token for assembly. The assembly must be the name of a file that contains an assembly manifest.

Sn.exe computes the token by using a hash function from the public key. To save space, the runtime stores public key tokens in the manifest as part of a reference to another assembly when it records a dependency to an assembly that has a strong name. The -Tp option displays the public key in addition to the token.

Note that this option does not verify the assembly signature and should not be used to make trust decisions. This option only displays the raw public key token data.

-TSassembly infile

Test-signs the signed or partially signed assembly with the key pair in infile.

-TSc assembly container

Test-signs the signed or partially signed assembly with the key pair in the key container container.

-v assembly

Verifies the strong name in assembly, where assembly is the name of a file that contains an assembly manifest.

-vf assembly

Verifies the strong name in assembly. Unlike the -v option, -vf forces verification even if it is disabled using the -Vr option.

-Vl

Lists current settings for strong-name verification on this computer.

-Vr assembly [userlist] [infile]

Registers assembly for verification skipping. Optionally, you can specify a comma-separated list of user names. If you specify infile, verification remains enabled, but the public key in infile is used in verification operations. Assembly can be specified in the form *, strongname to register all assemblies with the specified strong name. Strongname should be specified as the string of hexadecimal digits representing the tokenized form of the public key. See the -t and -T options to display the public key token.

Caution

Use this option only during development. Adding an assembly to the skip verification list creates a security vulnerability. A malicious assembly could use the fully specified assembly name (assembly name, version, culture, and public key token) of the assembly added to the skip verification list to fake its identity. This would allow the malicious assembly to also skip verification.

-Vu assembly

Unregisters assembly for verification skipping. The same rules for assembly naming that apply to -Vr apply to -Vu.

-Vx

Removes all verification-skipping entries.

-?

Displays command syntax and options for the tool.

April 2011

Added information about using the Visual Studio and Windows SDK Command Prompts.

Information enhancement.

August 2010

Added information about running the tool on 64-bit computers.

Information enhancement.

-c [csp]

Legt den für das Signieren mit starken Namen zu verwendenden kryptografischen Standarddienstanbieter (Cryptographic Service Provider, CSP) fest. Diese Einstellung gilt für den gesamten Computer. Wenn Sie keinen CSP-Namen angeben, löscht Sn.exe die aktuelle Einstellung.

-d container

Löscht den angegebenen Schlüsselcontainer aus dem CSP für starke Namen.

-D Assembly1 Assembly2

Überprüft, ob sich zwei Assemblys nur in der Signatur unterscheiden. Diese Prüfung wird häufig verwendet, nachdem eine Assembly mit einem anderen Schlüsselpaar neu signiert wurde.

-e Assembly-Ausgabedatei

Extrahiert den öffentlichen Schlüssel aus Assembly und speichert ihn in Ausgabedatei.

-h

Zeigt Befehlssyntax und Optionen für das Tool an.

-i Eingabedatei Container

Installiert das Schlüsselpaar aus infile in dem angegebenen Schlüsselcontainer. Der Schlüsselcontainer befindet sich im CSP für starke Namen.

-k [Schlüsselgröße] Ausgabedatei

Generiert einen neuen RSACryptoServiceProvider-Schlüssel mit der angegebenen Größe und schreibt ihn in die angegebene Datei. Sowohl ein öffentlicher als auch ein privater Schlüssel wird in die Datei geschrieben.

Wenn Sie keine Schlüsselgröße angeben, wird standardmäßig ein 1.024-Bit-Schlüssel generiert, sofern Microsoft Enhanced Cryptographic Provider installiert ist; andernfalls wird ein 512-Bit-Schlüssel generiert.

Bei Installation von Microsoft Enhanced Cryptographic Provider unterstützt der Parameter keysize Schlüssel mit einer Länge von 384 bis 16.384 Bits in 8-Bit-Schritten. Bei Installation von Microsoft Base Cryptographic Provider unterstützt der Parameter Schlüssel mit einer Länge von 384 bis 512 Bits in 8-Bit-Schritten.

-m [y|n]

Legt fest, ob Schlüsselcontainer computerspezifisch oder benutzerspezifisch sind. Wenn Sie y angeben, sind die Schlüsselcontainer computerspezifisch. Wenn Sie n angeben, sind die Schlüsselcontainer benutzerspezifisch.

Wenn weder y noch n angegeben wird, zeigt diese Option die aktuelle Einstellung an.

-o Eingabedatei [Ausgabedatei]

Extrahiert den öffentlichen Schlüssel aus Eingabedatei und speichert ihn in einer CSV-Datei. Die einzelnen Bytes des öffentlichen Schlüssels werden durch Komma getrennt. Dieses Format eignet sich zum Hartcodieren von Schlüsselverweisen als initialisierte Arrays im Quellcode. Wenn Sie keine Ausgabedatei angeben, wird die Ausgabe dieser Option in der Zwischenablage gespeichert.

Hinweis

Diese Option überprüft nicht, ob die Eingabe nur ein öffentlicher Schlüssel ist. Wenn infile ein Schlüsselpaar mit einem privaten Schlüssel enthält, wird der private Schlüssel auch extrahiert.

-p Eingabedatei Ausgabedatei

Extrahiert den öffentlichen Schlüssel aus dem Schlüsselpaar in Eingabedatei und speichert ihn in Ausgabedatei. Dieser öffentlichen Schlüssel kann zum verzögerten Signieren einer Assembly unter Verwendung der Optionen /delaysign+ und /keyfile des Assembly Linker-Tools (Al.exe) verwendet werden. Beim verzögerten Signieren einer Assembly wird während der Kompilierung nur der öffentliche Schlüssel festgelegt und Speicherplatz in der Datei reserviert, damit die Signatur hinzugefügt werden kann, sobald der private Schlüssel bekannt ist.

-pc Container Ausgabedatei

Extrahiert den öffentlichen Schlüssel aus dem Schlüsselpaar in Container und speichert ihn in Ausgabedatei.

-Pb [y|n]

Legt fest, ob die Bypassrichtlinie für starke Namen durchgesetzt wird. Wenn Sie y festlegen, werden starke Namen für voll vertrauenswürdige Assemblys beim Laden in ein voll vertrauenswürdiges AppDomain nicht geprüft. Wenn Sie n festlegen, werden starke Namen auf Korrektheit geprüft, jedoch nicht auf bestimmte starke Namen. StrongNameIdentityPermission hat keine Auswirkung auf voll vertrauenswürdige Assemblys. Sie müssen eine eigene Überprüfung der Übereinstimmung auf starke Namen durchführen.

Wenn weder y noch n festgelegt ist, zeigt diese Option die aktuelle Einstellung. Der Standardwert ist y.

Hinweis

Auf 64-Bit-Computern müssen diese Parameter sowohl in der 32-Bit- als auch in der 64-Bit-Instanz von Sn.exe festgelegt werden.

-q[uiet]

Gibt den stillen Modus an, in dem die Anzeige von Erfolgsmeldungen unterdrückt wird.

-R[a] Assembly Eingabedatei

Signiert eine bereits signierte oder eine verzögert signierte Assembly mit dem Schlüsselpaar in der Eingabedatei neu.

Wenn -Ra verwendet wird, werden Hashes für alle Dateien in der Assembly neu berechnet.

-Rc[a] Assembly Container

Signiert eine bereits signierte oder eine verzögert signierte Assembly mit dem Schlüsselpaar in Container neu.

Wenn -Rca verwendet wird, werden Hashes für alle Dateien in der Assembly neu berechnet.

-Rh Assembly

Berechnet Hashes für alle Dateien in der Assembly neu.

-t[p] Eingabedatei

Zeigt das in Eingabedatei gespeicherte Token für den öffentlichen Schlüssel an. Eingabedatei muss einen öffentlichen Schlüssel enthalten, der zuvor von einer Schlüsselpaardatei mithilfe von -p generiert wurde. Verwenden Sie nicht die Option -t[p], um ein Token direkt aus einer Schlüsselpaardatei zu extrahieren.

Sn.exe berechnet das Token mithilfe einer Hashfunktion aus dem öffentlichen Schlüssel. Um Speicherplatz zu sparen, speichert die Common Language Runtime Token für öffentliche Schlüssel im Manifest als Teil eines Verweises auf eine weitere Assembly, wenn eine Abhängigkeit zu einer Assembly mit starkem Namen aufgezeichnet wird. Die Option -tp zeigt zusätzlich zum Token den öffentlichen Schlüssel an.

Beachten Sie, dass bei Verwendung dieser Option die Assemblysignatur nicht überprüft wird, und sie daher nicht für Entscheidungen über Vertrauensstellungen verwendet werden sollte. Durch diese Option werden nur die unformatierten Tokendaten des öffentlichen Schlüssels angezeigt.

-T[p] Assembly

Zeigt das Token des öffentlichen Schlüssels für die Assembly an. Die Assembly muss dem Namen einer Datei entsprechen, die ein Assemblymanifest enthält.

Sn.exe berechnet das Token mithilfe einer Hashfunktion aus dem öffentlichen Schlüssel. Um Speicherplatz zu sparen, speichert die Laufzeit Token für öffentliche Schlüssel im Manifest als Teil eines Verweises auf eine weitere Assembly, wenn eine Abhängigkeit zu einer Assembly mit starkem Namen aufgezeichnet wird. Die Option -Tp zeigt zusätzlich zum Token den öffentlichen Schlüssel an.

Beachten Sie, dass bei Verwendung dieser Option die Assemblysignatur nicht überprüft wird, und sie daher nicht für Entscheidungen über Vertrauensstellungen verwendet werden sollte. Durch diese Option werden nur die unformatierten Tokendaten des öffentlichen Schlüssels angezeigt.

-TSassembly infile

Signiert die vollständig oder teilweise signierte assembly mit dem Schlüsselpaar in der infile zu Testzwecken.

-TSc assembly container

Signiert die vollständig oder teilweise signierte assembly mit dem Schlüsselpaar im Schlüsselcontainer container zu Testzwecken.

-v Assembly

Überprüft den starken Namen in Assembly, wobei Assembly der Name einer Datei ist, die ein Assemblymanifest enthält.

-vf Assembly

Überprüft den starken Namen in der Assembly. Im Unterschied zur Option -v wird die Überprüfung bei -vf auch dann erzwungen, wenn diese mit der Option -Vr deaktiviert wurde.

-Vl

Listet aktuelle Einstellungen für die Überprüfung starker Namen auf dem Computer auf.

-Vr Assembly [Benutzerliste] [Eingabedatei]

Registriert Assembly für das Überspringen bei der Überprüfung. Optional können Sie eine durch Trennzeichen getrennte Liste von Benutzernamen angeben. Wenn Sie Eingabedatei angeben, bleibt die Überprüfung aktiviert, es wird jedoch der öffentliche Schlüssel in Eingabedatei bei Überprüfungsvorgängen verwendet. Assembly kann in der Form *, strongname angegeben werden, um alle Assemblys mit dem angegebenen starken Namen zu registrieren. Strongname muss als die Zeichenfolge hexadezimaler Ziffern angegeben werden, die die Tokendarstellung des öffentlichen Schlüssels angibt. Siehe die Optionen -t und -T zum Anzeigen des Tokens des öffentlichen Schlüssels.

Vorsicht

Verwenden Sie diese Option nur bei der Entwicklung. Das Überspringen der Überprüfung einer Assembly kann ein erhebliches Sicherheitsrisiko darstellen. Wenn die Überprüfung einer Assembly übersprungen wird, besteht die Gefahr, dass deren vollständig angegebener Assemblyname (Assemblyname, Version, Kultur und öffentliches Schlüsseltoken) als falsche Identität einer böswilligen Assembly verwendet wird. Dadurch würde auch die Überprüfung der böswilligen Assembly übersprungen.

-Vu Assembly

Hebt die Registrierung von Assembly für das Überspringen bei der Überprüfung auf. Für -Vu gelten dieselben Regeln für die Angabe der Assembly wie bei -Vr.

-Vx

Entfernt alle Einträge für das Überspringen bei der Überprüfung.

-?

Zeigt Befehlssyntax und Optionen für das Tool an.

April 2011

Hinzugefügte Informationen zur Verwendung der Visual Studio- und Windows SDK-Eingabeaufforderungen.

Informationsergänzung.

August 2010

Informationen zum Ausführen des Tools auf 64-Bit-Computern wurden hinzugefügt.

Informationsergänzung.