Update-Module

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

这是 Microsoft.PowerShell.PSResourceGet 中 cmdlet 的代理 cmdletUpdate-PSResource。 有关详细信息，请参阅 Update-PSResource。

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

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模块更新需要提升的权限。

PowerShell 库不再支持传输层安全性（TLS）版本 1.0 和 1.1。 必须使用 TLS 1.2 或更高版本。 使用以下命令确保使用的是 TLS 1.2：

[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12

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

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

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

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