Privexec 项目使用教程

Privexec 项目使用教程

Privexec Run the program with the specified permission level (C++20 required) 项目地址: https://gitcode.com/gh_mirrors/pr/Privexec

1. 项目目录结构及介绍

Privexec 项目的目录结构如下：

Privexec/
├── AppExec/
├── Privexec/
├── cmake/
│   └── modules/
├── config/
├── docs/
├── include/
├── lib/
├── resources/
├── script/
├── test/
├── tools/
├── vendor/
├── wsudo/
├── clang-format
├── clang_complete
├── cmake-format.json
├── gitignore
├── CMakeLists.txt
├── LICENSE
├── ReadMe.md
├── ReadMe.zh-CN.md
├── build.ps1

目录介绍：

• AppExec/：包含与 AppContainer 相关的文件。
• Privexec/：包含 Privexec 核心文件。
• cmake/：包含 CMake 模块文件。
• config/：包含项目的配置文件。
• docs/：包含项目的文档文件。
• include/：包含项目的头文件。
• lib/：包含项目的库文件。
• resources/：包含项目的资源文件。
• script/：包含项目的脚本文件。
• test/：包含项目的测试文件。
• tools/：包含项目的工具文件。
• vendor/：包含项目的第三方依赖文件。
• wsudo/：包含 wsudo 相关的文件。
• clang-format：用于代码格式化的配置文件。
• clang_complete：用于代码补全的配置文件。
• cmake-format.json：用于 CMake 文件格式化的配置文件。
• gitignore：Git 忽略文件配置。
• CMakeLists.txt：CMake 构建文件。
• LICENSE：项目许可证文件。
• ReadMe.md：项目的英文介绍文件。
• ReadMe.zh-CN.md：项目的中文介绍文件。
• build.ps1：用于构建项目的 PowerShell 脚本。

2. 项目启动文件介绍

Privexec 项目的启动文件主要是 Privexec/Privexec.exe 和 wsudo/wsudo.exe。

Privexec.exe

• 功能：Privexec 是一个 GUI 客户端，允许用户以指定的权限级别运行程序。
• 启动方式：双击 Privexec.exe 或在命令行中运行 Privexec.exe。

wsudo.exe

• 功能：wsudo 是 Privexec 的命令行版本，允许用户在命令行中以指定的权限级别运行程序。
• 启动方式：在命令行中运行 wsudo 命令，例如 wsudo -A pwsh -NoProfile。

3. 项目配置文件介绍

Privexec 项目的配置文件主要位于 config/ 目录下，其中最重要的配置文件是 Privexec.json。

Privexec.json

• 功能：该文件用于配置 Privexec 和 wsudo 的别名和其他运行参数。
• 内容示例：

  {
    "alias": [
      {
        "description": "Edit Hosts",
        "name": "edit-hosts",
        "target": "Notepad %windir%\\System32\\Drivers\\etc\\hosts"
      },
      {
        "description": "Windows Debugger",
        "name": "windbg",
        "target": "\"%ProgramFiles(x86)%\\Windows Kits\\10\\Debuggers\\x64\\windbg.exe\""
      }
    ]
  }
  

• 配置说明：
  • alias：定义了命令别名，用户可以通过这些别名快速执行常用命令。
  • description：别名的描述信息。
  • name：别名的名称。
  • target：别名对应的实际命令。

通过以上配置文件，用户可以自定义 Privexec 和 wsudo 的行为，使其更符合个人或项目的需求。

Privexec Run the program with the specified permission level (C++20 required) 项目地址: https://gitcode.com/gh_mirrors/pr/Privexec