配置命令 (winget)

winget 工具的配置命令使用 WinGet 配置文件开始将 Windows 计算机设置为所需的开发环境状态。

警告

如果不首先查看文件的内容并验证相关资源的可信度,请不要运行 WinGet 配置文件。 请参阅如何检查 WinGet 配置文件的可信度

先决条件

  • Windows 10 版本 1809(内部版本 17763)或更高版本,或 Windows 11。
  • WinGet 版本 v1.6.2631 或更高版本

别名

以下是此命令的可用别名:

  • 配置
  • dsc

用法

winget configure -f <C:/Users/<username>/winget-configs/config-file-name.dsc.winget>

确定想要使用的 WinGet 配置文件后,确认该文件的安全性和可信度,并将该文件下载到本地计算机后,可以使用 winget configure 该命令启动配置设置。

列出 winget 配置命令选项的屏幕截图。

参数和选项

可使用以下参数:

论点 DESCRIPTION
-f, --file winget 配置文件的路径。
--module-path 指定要存储模块的本地计算机上的位置。 默认 %LOCALAPPDATA%\Microsoft\WinGet\Configuration\Modules。
--processor-path 指定配置处理器的路径。
-h,--history 从历史记录中选择项。
--accept-configuration-agreements 接受配置警告,防止交互式提示。
--隐藏初始细节 如果可能,禁止显示初始配置详细信息。
--enable 启用配置组件。 需要存储访问权限。
--disable 禁用配置组件。 需要存储访问权限。
-?,--help 显示有关所选命令的帮助。
--等 提示用户在退出之前按任意键。
--logs,--open-logs 打开默认日志位置。
--verbose,--verbose-logs 启用 winget 的详细日志记录。
--nowarn,--ignore-warnings 禁止警告输出。
--disable-interactivity 禁用交互式提示。
--proxy 设置要用于此执行的代理。
--no-proxy 禁用此执行使用代理。

配置子命令

winget configure 命令包括多个子命令,包括:

  • winget configure show:显示配置文件的详细信息。 用法:winget configure show -f <file>。 运行命令: winget configuration show configuration.dsc.yaml 将在当前工作目录中显示配置的详细信息。
  • winget configure list:显示已应用于系统的配置的高级详细信息。 然后,此数据可以与其他命令一起使用 configure ,以获取更多详细信息。 用法:winget configure list [<options>]
  • winget configure test:根据所需状态检查系统,显示当前系统状态是否符合关联配置文件中定义的所需状态。 用法:winget configure test -f <file>
  • winget configure validate:验证配置文件。 用法:winget configure validate [-f] <file> [<options>]
  • winget configure export:将配置资源导出到配置文件。 使用 --all时,导出所有包配置。 使用 --package-id时,导出给定包标识符的 WinGetPackage 资源。 当与 --module--resource 一起使用时,会导出指定资源的设置。 如果输出配置文件已存在,则追加导出的配置资源。 用法:winget configure export -o <output file> [<options>]