通过

uwfmgr.exe

  • 项目
  • 适用于:
    ✅ Windows 11, ✅ Windows 10

可以在命令行或 PowerShell 中使用 UWFMgr 工具来配置和检索统一写入筛选器 (UWF) 的设置。

重要

具有标准帐户的用户可以使用用于检索信息的命令，但只有具有管理员帐户的用户才可以使用用于更改配置设置的命令。

语法

uwfmgr.exe
    Help | ?
    Get-Config
    Filter
        Help | ?
        Enable
        Disable
        Reset-Settings
        Shutdown
        Restart
    Volume
        Help | ?
        Get-Config {<volume> | all}
        Protect {<volume> | all}
        Unprotect <volume>
    File
        Help | ?
        Get-Exclusions {<volume> | all}
        Add-Exclusion <file>
        Remove-Exclusion <file>
        Commit <file>
        Commit-Delete <file>
    Registry
        Help | ?
        Get-Exclusions
        Add-Exclusion <key>
        Remove-Exclusion <key>
        Commit <key> [<value>]
        Commit-Delete <key> [<value>]
    Overlay
        Help | ?
        Get-Config
        Get-AvailableSpace
        Get-Consumption
        Set-Size <size>
        Set-Type {RAM | DISK}
        Set-WarningThreshold <size>
        Set-CriticalThreshold <size>
        Set-Passthrough <on/off>
        Set-Persistent <on/off>
        Reset-PersistentState <on/off>
    Servicing
        Enable
        Disable
        Update-Windows
        Get-Config
        Help

位置

Uwfmgr 可在 %WINDIR%\System32\ 文件夹下找到。

命令行选项和参数

下面的列表介绍了可在 uwfmgr.exe 中使用的选项和子选项，还列出了每个命令行选项及子选项（如果可用）的相应 WMI 类或方法。

  • 帮助 | ？

    • 显示适用于 uwfmgr.exe 的基本参数的命令行帮助。

  • Get-Config

    • 显示当前会话和下一会话的 UWF 配置设置。

  • Filter

    • 配置基本 UWF 设置。
    • UWF_Filter
    • 启用
    • 禁用
    • 重置设置
      • 将 UWF 设置还原到原始状态。
        如果使用打开或关闭或 DISM 打开或关闭 Windows 功能将 UWF 添加到映像，则原始状态是首次启用 UWF 时 UWF 设置的状态。
        如果在无人参与文件中使用 SMI 设置将 UWF 添加到映像，则原始状态是在设备上安装 Windows 时 UWF 设置的状态。 从 Windows 10 开始，不再支持此命令。
      • UWF_Filter.ResetSettings
    • 关机
      • 立即关闭设备，即使覆盖已满或快满。 需要管理员级权限才能使用此命令。
      • UWF_Filter.ShutdownSystem
    • 重启
      • 立即关闭设备然后重新启动，即使覆盖已满或快满。 需要管理员级权限才能使用此命令。
      • UWF_Filter.RestartSystem

  • 体积

    • 配置受 UWF 保护的卷的设置。 如果需要 <volume> 参数，可以指定驱动器号（例如 uwfmgr.exe volume protect C:），或者可以指定所有卷（例如 uwfmgr.exe volume get-config all）。
    • UWF_Volume
    • 帮助 | ？
      • 显示 uwfmgr.exe volume 命令的命令行帮助。
    • Get-Config {<volume> | all}
      • 显示指定卷的配置设置和文件排除，如果指定了所有卷，则显示所有卷的。 显示当前会话和下一会话的信息。
      • UWF_Volume
    • Protect {<volume> | all}
      • 将指定的卷添加到受 UWF 保护的卷列表。 如果启用了 UWF 筛选，UWF 将在下一次系统重新启动后开始保护相应卷。
      • UWF_Volume.Protect
    • 取消保护<卷>
      • 从受 UWF 保护的卷中删除指定的卷。 在下一次系统重新启动后，UWF 停止保护相应卷。
      • UWF_Volume.Unprotect

  • 文件

    • 为 UWF 配置文件排除设置。 如果使用 <file> 参数，则它必须是完全限定的（包括卷和路径）。 uwfmgr.exe 使用在 <file> 参数中指定的卷来确定哪个卷包含该文件的文件排除列表。
    • UWF_Volume
    • 帮助 | ？
      • 显示 uwfmgr.exe file 命令的命令行帮助。
    • Get-Exclusions {<volume> | all}
      • 显示指定卷排除列表中的所有文件和目录（例如 uwfmgr.exe file Get-Exclusions C:），如果指定了所有卷，则显示所有卷的。 显示当前会话和下一会话的信息。
      • UWF_Volume.GetExclusions
    • Add-Exclusion <文件>
      • 将指定的文件添加到受 UWF 保护的卷的文件排除列表中。 在下一次系统重新启动后，UWF 开始从筛选中排除文件。
      • UWF_Volume.AddExclusion
    • Remove-Exclusion <文件>
      • 从受 UWF 保护的卷的文件排除列表中删除指定的文件。 在下一次系统重新启动后，UWF 停止从筛选中排除文件。
      • UWF_Volume.RemoveExclusion
    • 提交<文件>
      • 针对受 UWF 保护的卷，将对指定文件的更改提交到覆盖。 需要管理员级权限才能使用此命令。
      • UWF_Volume.CommitFile
    • Commit-Delete <文件>

  • 注册表

    • 为 UWF 配置注册表项排除设置。
    • UWF_RegistryFilter
    • 帮助 | ？
      • 显示 uwfmgr.exe registry 命令的命令行帮助。
    • Get-Exclusions
    • Add-Exclusion<key>
      • 将指定的注册表项添加到 UWF 的注册表排除列表。 在下一次系统重新启动后，UWF 开始从筛选中排除注册表项。
      • UWF_RegistryFilter.AddExclusion
    • Remove-Exclusion <键>
      • 从 UWF 的注册表排除列表中删除指定的注册表项。 在下一次系统重新启动后，UWF 停止从筛选中排除注册表项。
      • UWF_RegistryFilter.RemoveExclusion
    • 提交<键><值>
    • Commit-Delete <键> [<value>]
      • 删除指定的注册表项或值，并提交该删除操作。 如果值为空，则删除所有值和子项，并提交删除操作。 需要管理员级权限才能使用此命令。
      • UWF_RegistryFilter.CommitRegistryDeletion

  • Overlay

    • 配置用于 UWF 覆盖的设置。
    • UWF_Overlay 和 UWF_OverlayConfig
    • 帮助 | ？
      • 显示 uwfmgr.exe overlay 命令的命令行帮助。
    • Get-Config
    • Get-AvailableSpace
      • 显示可用于 UWF 覆盖的剩余空间量。
      • UWF_Overlay
    • Get-Consumption
      • 显示 UWF 覆盖当前使用的空间量。
      • UWF_Overlay
    • Set-Size 大小 <>
    • Set-Type {RAM | DISK}
      • 将覆盖存储的类型设置为基于 RAM 或基于磁盘。 必须在当前会话中禁用 UWF，才能将覆盖类型设置为基于磁盘。
      • UWF_OverlayConfig.SetType
    • Set-WarningThreshold <大小>
    • Set-CriticalThreshold <大小>
    • Set-Passthrough <on/off>
    • Set-Persistent <on/off>
      • 将覆盖层设置为持久性覆盖，以使用户在重新启动后能够继续使用其数据。
    • Reset-PersistentState <on/off>
      • 清除下次启动时的持久性覆盖（打开/关闭）。

  • 服务

    • 为 UWF 服务模式配置设置。
    • UWF_Servicing
    • 启用
      • 重新启动后，在下一个会话中启用服务模式。 需要管理员级权限才能使用此命令。
      • UWF_Servicing.Enable
    • 禁用
      • 重新启动后，在下一个会话中禁用 UWF 服务模式。 需要管理员级权限才能使用此命令。
      • UWF_Servicing.Disable
    • Update-Windows
      • 将 Windows 更新应用到设备的独立命令。 由 uwfmgr.exe servicing enable 命令调用的主服务脚本进行调用。 建议尽量使用 uwfmgr.exe servicing enable 命令来为受 UWF 保护的设备提供服务。 需要管理员级权限才能使用此命令。
      • UWF_Servicing.UpdateWindows
    • Get-Config
      • 显示当前会话和下一会话的 UWF 服务模式信息。
      • UWF_Servicing
    • 帮助
      • 显示 uwfmgr.exe servicing 命令的命令行帮助。

不受支持的 WMI 方法

以下列表包含当前不受 uwfmgr.exe 工具支持的 UWF WMI 提供程序方法 ：