通过

uwfmgr.exe

UWFMgr 工具可在命令行或 PowerShell 中使用，以配置和检索 统一写入筛选器 (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 配置设置。

  • 滤波器

    • 配置基本 UWF 设置。
    • UWF_Filter
    • Enable
    • 禁用
    • Reset-Settings
      • 将 UWF 设置还原到原始状态。
        如果使用 打开或关闭 Windows 功能或使用 DISM 将 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
    • 保护 {<volume> | all}
      • 将指定的卷添加到受 UWF 保护的卷列表中。 如果启用了 UWF 筛选，则 UWF 将在下次系统重启后开始保护卷。
      • UWF_Volume.Protect
    • 取消保护<卷>
      • 从受 UWF 保护的卷列表中删除指定的卷。 UWF 在下一次系统重启后停止保护卷。
      • UWF_Volume.Unprotect

  • 文件

    • 为 UWF 配置文件排除设置。 如果使用 <文件> 参数，则必须完全限定它，包括卷和路径。 uwfmgr.exe 使用文件>参数中指定的<卷来确定哪个卷包含该文件的文件排除列表。
    • 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<密钥>
      • 将指定的注册表项添加到 UWF 的注册表排除列表。 UWF 在下一次系统重启后开始从筛选中排除注册表项。
      • UWF_RegistryFilter.AddExclusion
    • Remove-Exclusion<键>
      • 从 UWF 的注册表排除列表中删除指定的注册表项。 UWF 在下一次系统重启后停止从筛选中排除注册表项。
      • UWF_RegistryFilter.RemoveExclusion
    • 提交<键><值>
    • Commit-Delete<键> [<value>]
      • 删除指定的注册表项和值，并提交删除操作。 如果值为空，则删除所有值和子项，并提交删除操作。 使用此命令需要管理员级权限。
      • UWF_RegistryFilter.CommitRegistryDeletion

  • 覆盖

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

  • 维护

    • 配置 UWF 服务模式的设置。
    • UWF_Servicing
    • Enable
      • 重启后在下一个会话中启用服务模式。 使用此命令需要管理员级权限。
      • 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 提供程序方法：