Freigeben über


Permissions View-Tool (Permview.exe)

Mit dem Permissions View-Tool können Sie sich die minimalen, optionalen und verweigerten Berechtigungssätze anzeigen lassen, die durch eine Assembly angefordert wurden. Optional können Sie über Permview.exe auch die durch eine Assembly verwendete deklarative Sicherheit anzeigen lassen. Permview.exe ist nur in .NET Framework, Version 1.0 und 1.1, verfügbar.

permview [/output filename] [/decl] manifestfile

Parameter

Argument Beschreibung

manifestfile

Die Datei mit dem Assemblymanifest. Das Manifest kann eine eigenständige Datei sein oder in eine PE-Datei (Portable Executable) integriert sein. Die Erweiterung für diese Datei lautet normalerweise .exe oder .dll, aber auch .scr oder .ocx sind möglich.

Option Beschreibung

/decl

Zeigt die deklarative Sicherheit auf der Assembly-, Klassen- und Methodenebene für die durch manifestfile angegebene Assembly an. Dies schließt Anforderungen für Berechtigungen sowie weitere Anforderungen, Assertionen und alle anderen Sicherheitsaktionen ein, die deklarativ angewendet werden können. Sie gilt nicht für andere Assemblys, die mit der angegebenen Assembly verknüpft sind.

/h[elp]

Zeigt die Befehlssyntax und Optionen für das Tool an.

/output: filename

Schreibt die Ausgabe in die angegebene Datei. In der Standardeinstellung wird die Ausgabe in der Konsole angezeigt.

/?

Zeigt die Befehlssyntax und Optionen für das Tool an.

Hinweise

Entwickler können mit Permview.exe überprüfen, ob sie die Anforderungen für Berechtigungen richtig auf den Code angewendet haben. Außerdem können Benutzer Permview.exe ausführen, um die Berechtigungen zu bestimmen, die eine Assembly zum Ausführen benötigt. Wenn Sie z. B. eine verwaltete ausführbare Datei ausführen und der Fehler "System.Security.Policy.PolicyException: Erforderliche Berechtigungen wurden verweigert" auftritt, können Sie mit Permview.exe die Berechtigungen bestimmen, die der Code in der ausführbaren Datei erhalten muss, bevor diese ausgeführt werden kann.

Beispiele

Der folgende Befehl zeigt die durch die Assembly myAssembly.exe angeforderten Berechtigungen in der Konsole an.

permview myAssembly.exe

Wenn myAssembly.exe eine minimale Anforderung für FullTrust enthält, wird die folgende Ausgabe angezeigt.

Microsoft (R) .NET Framework Permission Request Viewer.  Version 1.0.2204.18 Copyright (C) Microsoft Corp. 1998-2000

minimal permission set:
<PermissionSet class="System.Security.PermissionSet" version ="1">
   <Unrestricted/>
</PermissionSet>

optional permission set:
   Not specified

refused permission set:
   Not specified

Der folgende Befehl zeigt die deklarative Sicherheit für die Assembly myAssembly.exe in der Konsole an. Dieser Befehl zeigt die Sicherheitsanforderungen auf Methodenebene an.

permview /decl myAssembly.exe

Die folgende Ausgabe wird angezeigt:

Microsoft (R) .NET Framework Permission Request Viewer.  
Version 1.0.2204.18 Copyright (C) Microsoft Corp. 1998-2000

Assembly RequestMinimum permission set:
<PermissionSet class="System.Security.PermissionSet" version ="1">
   <Unrestricted/>
</PermissionSet>

Method A::myMethod() LinktimeCheck permission set:
<PermissionSet class="System.Security.PermissionSet" version="1">
   <Permission class="System.Security.Permissions.ReflectionPermission,
      mscorlib, Ver=1.0.2204.2, Loc='', SN=03689116d3a4ae33" 
      version="1">
      <MemberAccess/>
   </Permission>
</PermissionSet>

Der folgende Befehl schreibt die durch die Assembly myAssembly.exe angeforderten Berechtigungen in die Datei myOutputFile.

permview /output myOutputFile myAssembly.exe 

Siehe auch

Referenz

.NET Framework-Tools

Konzepte

Anfordern von Berechtigungen
Deklarative Sicherheit
Forderungen
Verwenden der Assert-Methode
Verwenden der Deny-Methode
Verwenden der PermitOnly-Methode

Weitere Ressourcen

Assemblys in der Common Language Runtime (CLR)