通过

脚本和语法

  • 项目

CreateWSKAppsFM 语法

CreateWSKAppsFM {-FMFile: [path]} {-AppsFolder [Path]} {-IncludeWow}
参数 说明
-FMFile [路径] 要创建的 FM 文件的路径。 默认情况下更新 %WSKWorkspaceRoot%\FMFiles\OEMAppsFM.xml。
-AppsFolder [路径] 要在其中搜索应用的文件夹的路径。 默认情况下搜索 %WSKWorkspaceRoot%\Apps。
-IncludeWow 在 amd64 映像上添加了对 x86 的支持，在 arm64 映像上添加了对 arm 的支持。

CreateWSKCustomizationsFM 语法

CreateWSKCustomizationsFM [-OEMPackagesFolder <folder>] [-Version <version>] [-FMFile <FMFile>] [-CustomizationXML <XML>]
参数 选项
-OEMPackagesFolder 指定存储自定义包的文件夹路径。 此文件夹中的所有自定义包都将包含在功能清单中。 默认路径为 %WSKWorkspaceRoot%\OEMCustomization\CustomizationXML。
-Version 用于添加一个追加到包名称的版本号。 格式为 xxxx.y.z.z。 默认值为 1000.0.0.0。
-FMFile 用于指定自定义功能清单文件（定义自定义设置）的路径。 此 FM 会添加到 OEMInput 文件中，这样这些设置就会包含在映像中。 默认值为 %WSKWorkspaceRoot%\FMFiles\OEMCustomizationsFM.xml。
-CustomizationXML CustomizationXML 文件或包含自定义文件的文件夹的路径。 如果指定文件夹路径，则所有自定义设置 xml 文件都会得到处理，并会输出单个设置 FM。 如果未指定此选项，则默认路径为 %WSKWorkspaceRoot%\OEMCustomization\CustomizationXML.xml。

CreateWSKCustomizationsXML 语法

CreateWSKCustomizationsXML [-Categorize] [-Advanced]
参数 说明
-Categorize 将 CustomizationXML 拆分成多个文件，每个自定义项都有一个文件。 如果未使用此选项，则会创建一个大型自定义文件
-Advanced 生成电源设置自定义 XML

有关详细信息，请参阅生成一个设置自定义文件。

CreateWSKDriversFM 语法

CreateWSKDriversFM {-FMFile: [path]} {-InfFolder [Path]}
参数 说明
-FMFile [路径] 要创建的 FM 文件的路径。 默认情况下创建或替换“%WSKWorkspaceRoot%\FMFiles\OEMDriversFM.xml”。
-InfFolder [路径] 要在其中搜索驱动程序的文件夹的路径。 默认情况下搜索 %WSKWorkspaceRoot%\DCHUDrivers。

有关详细信息，请参阅生成设置自定义包并将其添加到 OEMInput 文件。

ImageSigner 语法

imagesigner Sign <FFUFile> <path to catalog file>
imagesigner GetCatalog <FFUFile> <path to catalog file>
imagesigner Truncate <FFUFile> <path to truncated FFU>

参数：

参数 说明
签名 对 FFU 文件进行签名。
GetCatalog 从 FFU 文件中提取目录，并将其写入到目录文件中。 此选项可用于确定是否已正确准备 FFU，方法是使用文件属性或工具（如 SignTool）检查提取的目录文件。
Truncate 创建截断的 FFU。

路径：

路径 说明
FFUFile FFU 映像文件的路径。
CatalogFile 目录文件的路径。
TruncatedFFU 截断的 FFU 文件的路径。

PrepWSKWorkspace 语法

PrepWSKWorkspace {-Destination} <Path> {-Product [productname]} {-ProductConfiguration [Development|Manufacturing|ramboot_pre_oobe|ramboot_post_oobe]} {-Architecture [AMD64|x86|Arm|Arm64]} {-VM} {-Overwrite [YES|NO|PROMPT]} {-AdditionalLanguages [lang-lang,lang-lang]} {DefaultLanguage [default-language]}
参数 说明
-Destination（必需） 目标目录，例如 C:\Workspace。 如果此目录不存在，则脚本会创建它。 可以选择现有的工作区文件夹。

可能需要在电脑上启用长文件路径，具体取决于工作区的存储位置。
-Product（必需） 指定工作区支持的产品。

选项

  • FactoryOS
-ProductConfiguration 配置 PrepWSKWorkspace 创建的 OEMInput 文件。 ProductConfiguration 值区分大小写。

选项

  • Development：用于启动和测试。 如果在创建工厂 OS 工作区时未指定 -ProductConfiguration，则此值为默认值。
  • Manufacturing：使用减少的磁盘占用量和高性能电源管理模式配置映像。 适用于：工厂 OS
    • >
  • win32_manufacturing/win32_development：配置可在容器中运行诊断 win32 应用的工厂 OS 版本。 适用于：工厂 OS
-体系结构 [AMD64|x86|Arm|Arm64] 要构建的设备体系结构。 默认体系结构为 AMD64。
-VM 用于生成虚拟机映像。 添加 -VM 参数时，最终映像将是一个 .vhdx 文件 (UEFI)。 生成 VM 映像时，不会生成 FFU。
-Overwrite:[Yes|No|Prompt] 控制是否覆盖现有工作区。
  • Yes：覆盖目标文件夹中的任何冲突文件。
  • No：不覆盖目标文件夹中的任何冲突文件，而是将新文件复制进来。
  • Prompt：如果存在任何冲突的文件，则会在覆盖它们之前进行询问。 这是默认值。
-AdditionalLanguages [lang-lang] 用于将语言包和可供用户安装的功能添加到 OEMInput 文件。
使用语言-区域性格式指定语言，例如 de-de、fr-ca，等等。
-DefaultLanguage [default-language] 指定映像中的默认语言。 映像只能指定一种默认语言。
使用语言-区域性格式指定语言，例如 de-de、fr-ca，等等。确保默认语言是 OEMInput 文件中包含的语言。

PrepWSKWorkspace 示例

本部分包含的示例演示了如何为各种方案创建新工作区

基本工作区

  • 在 C:\Workspace 中创建工厂 OS 工作区

    PrepWSKWorkspace c:\Workspace -product FactoryOS

包含可选参数的工作区

  • 使用制造产品配置在 C:\Workspace 中创建工厂 OS VM

    PrepWSKWorkspace C:\Workspace -Product FactoryOS -ProductConfiguration Manufacturing -VM

SetImagGenEnv 语法

SetImageGenEnv.cmd [CeipOn | CeipOff | CeipDisable]
参数 说明
CeipOn 让用户选择加入客户体验改善计划 (CEIP)。 如果未提供此项，系统会通过对话框提示用户。
CeipOff 让用户选择退出客户体验改善计划 (CEIP)。 如果未提供此项，系统会通过对话框提示用户。
CeipDisable CEIP 注册状态没有变化。 但是，如果你已选择参与另一个 Windows 工具包，则此项不会将你取消注册。

UpdateWSKAppsFM 语法

UpdateWSKAppsFM {-FMFile: [path]} {-AppsFolder [Path]} {-IncludeWow}
参数 说明
-FMFile [路径] 要更新的 FM 文件的路径。 默认情况下创建或替换 %WSKWorkspaceRoot%\FMFiles\OEMAppsFM.xml。
-AppsFolder [路径] 要在其中搜索应用的文件夹的路径。 默认情况下搜索 %WSKWorkspaceRoot%\Apps。
-IncludeWow 如果设置了此项，它会将 x86 添加到 amd64 映像，将 arm 添加到 arm64 映像。

UpdateWSKDriversFM 语法

UpdateWSKDriversFM {-FMFile: [path]} {-InfFolder [Path]}
参数 说明
-FMFile [路径] 要更新的 FM 文件的路径。 默认情况下创建或替换 %WSKWorkspaceRoot%\FMFiles\OEMDriversFM.xml。
-InfFolder [路径] 要在其中搜索驱动程序的文件夹的路径。 默认情况下搜索 %WSKWorkspaceRoot%\DCHUDrivers。