Средство просмотра разрешений (Permview.exe)
Обновлен: Ноябрь 2007
Средство просмотра разрешений используется для просмотра наборов минимальных, необязательных и отклоненных разрешений, запрошенных сборкой. Программа Permview.exe позволяет также просматривать все элементы декларативной безопасности, используемые сборкой. Программа Permview.exe доступна только в версиях .NET Framework 1.0 и 1.1.
permview [/output filename] [/decl] manifestfile
Параметры
Аргумент |
Описание |
|---|---|
файл_манифеста |
Файл, в котором хранится манифест сборки. Манифест может находиться в отдельном файле или встраиваться в переносимый исполняемый файл (PE). Этот файл обычно имеет расширение .exe или .dll, иногда .scr или .ocx. |
Параметр |
Описание |
|---|---|
/decl |
Отображает все механизмы декларативной безопасности на уровне сборок, классов и методов для сборки, указанной параметром файл_манифеста. В этот список включаются запросы разрешений, а также требования, утверждения и другие действия, связанные с безопасностью, которые могут применяться декларативно. Сборки, связанные с указанной сборкой, не затрагиваются. |
/h[elp] |
Отображает синтаксис команд и параметров программы. |
/output имя_файла |
Перенаправляет вывод в указанный файл. По умолчанию вывод производится на консоль. |
/? |
Отображает синтаксис команд и параметров программы. |
Заметки
Разработчики могут использовать Permview.exe для проверки правильности применения запросов разрешений в программном коде. Кроме того, пользователи могут запускать Permview.exe для определения разрешений, необходимых для выполнения сборки. Так, например, если при запуске управляемого исполняемого файла возникла ошибка "System.Security.Policy.PolicyException: Failed to acquire required permissions", с помощью Permview.exe можно определить, каких разрешений не хватает коду исполняемого файла.
Примеры
Следующая команда выводит на консоль разрешения, запрашиваемые сборкой myAssembly.exe.
permview myAssembly.exe
Если сборка myAssembly.exe содержит минимальный запрос для FullTrust, выводятся следующие данные.
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
Следующая команда выводит на консоль все механизмы декларативной безопасности для сборки myAssembly.exe. Эта команда выводит требования безопасности уровня методов.
permview /decl myAssembly.exe
Будут выведены следующие данные.
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>
Следующая команда записывает разрешения, запрошенные сборкой myAssembly.exe, в файл myOutputFile.
permview /output myOutputFile myAssembly.exe
См. также
Основные понятия
Использование метода PermitOnly