Herramienta de vista de permisos (Permview.exe)

Actualización: noviembre 2007

Esta herramienta se utiliza para ver los conjuntos de permisos mínimos, opcionales y rechazados solicitados por un ensamblado. Opcionalmente se puede utilizar Permview.exe para ver la seguridad declarativa completa utilizada por un ensamblado. Permview.exe está disponible sólo en .NET Framework versiones 1.0 y 1.1.

permview [/output filename] [/decl] manifestfile

Parámetros

Argumento

Descripción

manifestfile

Archivo que contiene el manifiesto del ensamblado. El manifiesto puede ser un archivo independiente o se puede incorporar a un archivo ejecutable portable (PE). La extensión de este archivo suele ser .exe o .dll, pero también puede ser .scr y .ocx.

Opción

Descripción

/decl

Muestra la seguridad declarativa completa en el nivel de ensamblado, clase y método para el ensamblado especificado por el argumento manifestfile. Se incluyen solicitudes de permisos así como acciones de seguridad Demand y Assert y todas las demás acciones de seguridad que se pueden aplicar de forma declarativa. No hace referencia a otros ensamblados vinculados al ensamblado especificado.

/h[elp]

Muestra la sintaxis de comandos y opciones para la herramienta.

/output filename

Escribe los resultados en el archivo especificado. El valor predeterminado es que los resultados se muestren en la consola.

/?

Muestra la sintaxis de comandos y opciones para la herramienta.

Comentarios

Los programadores pueden utilizar Permview.exe para comprobar que han aplicado correctamente las solicitudes de permiso al código. Además, los usuarios pueden ejecutar Permview.exe para determinar los permisos que un ensamblado requiere para la ejecución. Por ejemplo, si se ejecuta un archivo ejecutable administrado y se obtiene el mensaje de error "System.Security.Policy.PolicyException: Error al adquirir los permisos requeridos", se puede utilizar Permview.exe para determinar los permisos que el código del archivo ejecutable debe recibir antes de la ejecución.

Ejemplos

El comando siguiente muestra los permisos solicitados por el ensamblado myAssembly.exe en la consola.

permview myAssembly.exe

Si myAssembly.exe contiene una solicitud mínima de FullTrust, se muestra el resultado siguiente.

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

El comando siguiente muestra la seguridad declarativa completa del ensamblado myAssembly.exe en la consola. Este comando muestra la demanda de seguridad en el nivel de método.

permview /decl myAssembly.exe

Se muestra el resultado siguiente.

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>

El comando siguiente escribe los permisos solicitados por el ensamblado myAssembly.exe en el archivo myOutputFile.

permview /output myOutputFile myAssembly.exe 

Vea también

Conceptos

Solicitar permisos

Seguridad declarativa

Peticiones

Utilizar el método Assert

Utilizar el método Deny

Utilizar el método PermitOnly

Referencia

Herramientas de .NET Framework

Otros recursos

Ensamblados en Common Language Runtime