Update-Module
將最新版的指定模組從在線資源庫下載並安裝到本機計算機。
語法
All
Update-Module
[[-Name] <String[]>]
[-RequiredVersion <Version>]
[-MaximumVersion <Version>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Update-Module Cmdlet 會從在線資源庫安裝模組的最新版本。 系統會提示您在安裝更新之前確認更新。 更新只會針對安裝在本機計算機上且具有 Install-Module的模組安裝。
Update-Module 搜尋已安裝模組 $env:PSModulePath。
Update-Module 沒有指定參數的更新所有已安裝的模組。 若要指定要更新的模組，請使用 Name 參數。 您可以使用 RequiredVersion 參數來更新模組的特定版本。
如果已安裝的模組已經是最新版本，則不會更新模組。 如果在 $env:PSModulePath中找不到模組，則會顯示錯誤。
若要顯示已安裝的模組，請使用 Get-InstalledModule。
範例
範例 1：更新所有模組
本範例會將所有已安裝的模組更新為在線資源庫中的最新版本。
Update-Module
範例 2：依名稱更新模組
本範例會將特定模組更新為在線資源庫中的最新版本。
Update-Module -Name SpeculationControl
Update-Module 使用 Name 參數來更新特定模組，SpeculationControl。
範例 3：檢視假設 Update-Module 執行
此範例會執行假設案例，以顯示執行 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 時會發生什麼情況。
範例 4：將模組更新為指定的版本
在此範例中，模組會更新為特定版本。 版本必須存在於在線資源庫中，否則會顯示錯誤。
Update-Module -Name SpeculationControl -RequiredVersion 1.0.14
Update-Module 使用 Name 參數來指定模組，SpeculationControl。
RequiredVersion 參數會指定版本，1.0.14。
範例 5：在不確認的情況下更新模組
此範例不會要求確認，以從在線資源庫將模組更新為最新版本。 如果已安裝模組，Force 參數會重新安裝模組。
Update-Module -Name SpeculationControl -Force
Update-Module 使用 Name 參數來指定模組，SpeculationControl。
Force 參數會更新模組，而不要求用戶確認。
參數
-Confirm
在執行 Update-Module之前，提示您進行確認。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | cf |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Force
強制更新每個指定的模組，而不提示要求確認。 如果已安裝模組，Force 重新安裝模組。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-MaximumVersion
指定要更新的單一模組最大版本。 如果您嘗試更新多個模組，則無法新增此參數。 MaximumVersion 和 RequiredVersion 參數不能在同一個命令中使用。
參數屬性
| 類型: | Version |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Name
指定要更新的一或多個模組名稱。
Update-Module
$env:PSModulePath 搜尋要更新的模組。 如果在指定模組名稱的 $env:PSModulePath 中找不到相符專案，就會發生錯誤。
模組名稱中接受通配符。 如果您將通配符新增至指定的名稱，而且找不到相符專案，則不會發生任何錯誤。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | True |
| 不要顯示: | False |
參數集
(All)
| Position: | 0 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-RequiredVersion
指定將更新現有已安裝模組的確切版本。 RequiredVersion 所指定的版本 必須存在於在線資源庫中，否則會顯示錯誤。 如果在單一指令中更新一個以上的模組，您就無法使用 requiredVersion 。
參數屬性
| 類型: | Version |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-WhatIf
顯示當 Update-Module 執行時會發生什麼事。 該 Cmdlet 未被執行。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 無線 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
備註
針對 PowerShell 5.1 或更新版本，提高許可權會話中的預設範圍是 AllUsers，且在未提高許可權的會話中，CurrentUser。
AllUsers、$env:ProgramFiles\PowerShell\Modules的模組更新需要更高的許可權。
CurrentUser、$home\Documents\PowerShell\Modules模組更新不需要提高的許可權。
Update-Module 在 PowerShell 3.0 或更新版本的 PowerShell、Windows 7 或 Windows 2008 R2 和更新版本的 Windows 上執行。
如果您使用 安裝使用 Install-Module 參數指定的模組，就會發生錯誤。
您只能執行 Update-Module，在從在線資源庫安裝的模組上執行 Install-Module。
如果 Update-Module 嘗試更新正在使用的二進位檔，Update-Module 會傳回識別問題處理程序的錯誤。 在停止進程之後，系統會通知使用者重試 Update-Module。