WinPETools 开源项目教程

WinPETools 开源项目教程

WinPEToolsA module designed to simplify the creation, customization, and deployment of bootable Windows Preinstallation Environment (WinPE) images.项目地址:https://gitcode.com/gh_mirrors/wi/WinPETools

1. 项目的目录结构及介绍

WinPETools 项目的目录结构如下：

WinPETools/
├── README.md
├── LICENSE
├── WinPEBuilder/
│   ├── WinPEBuilder.ps1
│   ├── Config/
│   │   ├── Config.xml
│   │   └── Modules/
│   │       ├── Module1.psm1
│   │       └── Module2.psm1
│   └── Resources/
│       ├── Image1.wim
│       └── Script1.ps1
└── WinPELauncher/
    ├── WinPELauncher.exe
    └── Config/
        ├── LauncherConfig.xml
        └── Scripts/
            ├── Script1.ps1
            └── Script2.ps1

目录结构介绍

• README.md: 项目说明文件，包含项目的基本信息和使用指南。
• LICENSE: 项目的开源许可证文件。
• WinPEBuilder: 用于构建 WinPE 镜像的脚本和配置文件。
  • WinPEBuilder.ps1: 主脚本文件，用于构建 WinPE 镜像。
  • Config: 配置文件目录。
    • Config.xml: 主配置文件，包含构建 WinPE 镜像的参数和选项。
    • Modules: 模块脚本目录，包含用于构建过程中的自定义模块。
  • Resources: 资源文件目录，包含构建过程中需要的镜像和脚本文件。
• WinPELauncher: 用于启动 WinPE 镜像的可执行文件和配置文件。
  • WinPELauncher.exe: 主可执行文件，用于启动 WinPE 镜像。
  • Config: 配置文件目录。
    • LauncherConfig.xml: 主配置文件，包含启动 WinPE 镜像的参数和选项。
    • Scripts: 脚本文件目录，包含启动过程中需要执行的脚本文件。

2. 项目的启动文件介绍

WinPELauncher.exe

WinPELauncher.exe 是项目的启动文件，负责启动构建好的 WinPE 镜像。该文件是一个可执行文件，用户可以通过双击该文件来启动 WinPE 镜像。

启动流程

1. 读取配置文件: WinPELauncher.exe 会读取 Config/LauncherConfig.xml 配置文件，获取启动参数和选项。
2. 执行启动脚本: 根据配置文件中的设置，执行 Config/Scripts 目录下的脚本文件。
3. 启动 WinPE 镜像: 根据配置文件中的路径信息，启动指定的 WinPE 镜像。

3. 项目的配置文件介绍

Config.xml

Config.xml 是 WinPEBuilder 目录下的主配置文件，用于配置构建 WinPE 镜像的参数和选项。

<Config>
  <ImageSource>Resources/Image1.wim</ImageSource>
  <OutputPath>C:/WinPEOutput</OutputPath>
  <Modules>
    <Module>Modules/Module1.psm1</Module>
    <Module>Modules/Module2.psm1</Module>
  </Modules>
  <Scripts>
    <Script>Resources/Script1.ps1</Script>
  </Scripts>
</Config>

配置项介绍

• ImageSource: 指定构建过程中使用的源镜像文件路径。
• OutputPath: 指定构建完成后输出镜像文件的路径。
• Modules: 指定构建过程中需要加载的模块脚本文件。
• Scripts: 指定构建过程中需要执行的脚本文件。

LauncherConfig.xml

LauncherConfig.xml 是 WinPELauncher 目录下的主配置文件，用于配置启动 WinPE 镜像的参数和选项。

<LauncherConfig>
  <ImagePath>C:/WinPEOutput/WinPE.wim</ImagePath>
  <Scripts>
    <Script>Config/Scripts/Script1.ps1</Script>
    <Script>Config/Scripts/Script2.ps1</Script>
  </Scripts>
</LauncherConfig>

配置项介绍

• ImagePath: 指定需要启动的 WinPE 镜像文件路径。
• Scripts: 指定启动过程中需要执行的脚本文件。

WinPEToolsA module designed to simplify the creation, customization, and deployment of bootable Windows Preinstallation Environment (WinPE) images.项目地址:https://gitcode.com/gh_mirrors/wi/WinPETools