Update-Module

该 Update-Module cmdlet 从联机库安装模块的最新版本。 在安装更新之前，系统会提示你确认更新。 仅针对在本地计算机上安装 Install-Module的模块安装更新。 Update-Module 搜索 $env:PSModulePath 已安装的模块。

Update-Module 未指定任何参数即可更新所有已安装的模块。 若要指定要更新的模块，请使用 Name 参数。 可以使用 RequiredVersion 参数更新到模块的特定版本。

采用模块版本号的参数需要格式化为版本号的字符串。

• 标准版本号的格式为 x.y.z x、y 和 z 是数字
• 预发行版版本的格式是x.y.z-<prerelease_label><prerelease_label>分配给该版本的任意字符串。

如果已安装的模块已是最新版本，则不会更新该模块。 如果未在模块中找到 $env:PSModulePath，则会显示错误。

若要显示已安装的模块，请使用 Get-InstalledModule。

此示例将所有已安装的模块更新到联机库中的最新版本。

Update-Module

此示例将特定模块更新到联机库中的最新版本。

Update-Module -Name SpeculationControl

Update-Module 使用 Name 参数更新特定模块 SpeculationControl。

此示例执行模拟方案，以显示运行时 Update-Module 会发生什么情况。 该命令未运行。

Update-Module -WhatIf

What if: Performing the operation "Update-Module" on target "Version '2.8.0' of module
  'Carbon', updating to version '2.8.1'".
What if: Performing the operation "Update-Module" on target "Version '1.0.10' of module
  'SpeculationControl', updating to version '1.0.14'".

Update-Module 使用 WhatIf 参数显示运行后 Update-Module 会发生什么情况。

在此示例中，模块将更新为特定版本。 该版本必须存在于联机库中，否则将显示错误。

Update-Module -Name SpeculationControl -RequiredVersion 1.0.14

Update-Module 使用 Name 参数指定模块 SpeculationControl。 RequiredVersion 参数指定版本 1.0.14。

此示例不请求确认将模块从联机库更新到最新版本。 如果模块已安装， Force 参数将重新安装该模块。

Update-Module -Name SpeculationControl -Force

Update-Module 使用 Name 参数指定模块 SpeculationControl。 Force 参数在不请求用户确认的情况下更新模块。

String[]

String

PSCredential

Uri

Object

PowerShell 包含以下与 Update-Module相关的别名：

• 所有平台：
  • upmo

对于 PowerShell 6.0 及更高版本，默认安装范围始终为 CurrentUser。 CurrentUser$HOME\Documents\PowerShell\Modules 的模块更新不需要提升的权限。 AllUsers 的$env:ProgramFiles\PowerShell\Modules模块更新需要提升的权限。

Update-Module 在 PowerShell 3.0 或更高版本的 PowerShell、Windows 7 或 Windows 2008 R2 及更高版本的 Windows 上运行。

如果未使用 Install-ModuleName 参数指定模块，则会发生错误。

只能通过运行从联机库安装的模块上运行Update-ModuleInstall-Module。

如果 Update-Module 尝试更新正在使用的二进制文件， Update-Module 则返回一个标识问题进程的错误。 在停止进程后，系统会通知用户重试 Update-Module 。