configure 工具的 winget 命令使用 WinGet 配置文件开始将Windows计算机设置为所需的开发环境状态。
configuration文件可以指定要与其他系统设置一起安装的包集合，使其成为可重现环境设置的最完整方法。
小窍门
对于更简单的方案，可以在单个命令（winget install A B C）中安装多个包，或使用 winget export 和 winget import 保存和还原包列表。
警告
如果不首先查看文件的内容并验证相关资源的可信度，请不要运行 WinGet 配置文件。 请参阅如何检查 WinGet 配置文件的可信度。
先决条件
- Windows 10 版本 1809（内部版本 17763）或更高版本，或 Windows 11。
- WinGet 版本 v1.6.2631 或更高版本。
别名
以下是此命令的可用别名：
configurationdsc
用法
winget configure -f <C:/Users/<username>/winget-configs/config-file-name.dsc.winget>
确定要使用的 WinGet configuration 文件、确认该文件安全且可信，并将其下载到本地计算机后，可以使用 winget configure 命令开始安装 configuration。
参数和选项
可使用以下参数：
| 论点 | DESCRIPTION |
|---|---|
-f、--file |
文件的路径 wingetconfiguration 。 |
--module-path |
指定要存储模块的本地计算机上的位置。 默认 %LOCALAPPDATA%\Microsoft\WinGet\Configuration\Modules。 |
--processor-path |
指定 configuration 处理器的路径。 |
-h、--history |
从历史记录中选择项。 |
--accept-configuration-agreements |
接受configuration警告，从而避免出现交互式提示。 |
--suppress-initial-details |
如果可能，禁止显示初始 configuration 详细信息。 |
--enable |
启用 configuration 组件。 需要存储访问权限。 |
--disable |
禁用 configuration 组件。 需要存储访问权限。 |
-?、--help |
显示有关所选命令的帮助。 |
--wait |
提示用户在退出之前按任意键。 |
--logs、--open-logs |
打开默认日志位置。 |
--verbose、--verbose-logs |
为 winget 启用详细日志记录。 |
--nowarn、--ignore-warnings |
禁止警告输出。 |
--disable-interactivity |
禁用交互式提示。 |
--proxy |
设置要用于此执行的代理。 |
--no-proxy |
禁用此执行使用代理。 |
configure 子命令
该 winget configure 命令包括多个子命令，包括：
-
winget configure show：显示文件的详细信息 configuration 。 用法：winget configure show -f <file>。 运行命令：winget configuration show configuration.dsc.yaml将显示当前工作目录中 configuration 的详细信息。 -
winget configure list：显示已应用于系统的配置的高级详细信息。 然后，此数据可以与其他命令一起使用configure，以获取更多详细信息。 用法：winget configure list [<options>] -
winget configure test：根据所需状态检查系统，显示当前系统状态是否符合关联 configuration 文件中定义的所需状态。 用法：winget configure test -f <file>。 -
winget configure validate：验证 configuration 文件。 用法：winget configure validate [-f] <file> [<options>]。 -
winget configure export：将资源导出 configuration 到 configuration 文件。 使用--all时，导出所有包配置。 使用--package-id时，导出给定包标识符的 WinGetPackage 资源。 当与--module和--resource一起使用时，会导出指定资源的设置。 如果输出 configuration 文件已存在，则追加导出 configuration 的资源。 用法：winget configure export -o <output file> [<options>]
