共用方式為

Update-PSResource

  • 參考
模組:
Microsoft.PowerShell.PSResourceGet

下載並安裝本機電腦上已安裝的最新套件版本。

Syntax

Update-PSResource
      [[-Name] <String[]>]
      [-Version <String>]
      [-Prerelease]
      [-Repository <String[]>]
      [-Scope <ScopeType>]
      [-TemporaryPath <String>]
      [-TrustRepository]
      [-Credential <PSCredential>]
      [-Quiet]
      [-AcceptLicense]
      [-Force]
      [-PassThru]
      [-SkipDependencyCheck]
      [-AuthenticodeCheck]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Update-PSResource 會下載並安裝已安裝在本機計算機上的最新套件版本。 此 Cmdlet 會取代 PowerShellGet v2 中的 Update-Module 和 Update-Script Cmdlet。 新版本的資源會與新版資料夾中的舊版並存安裝。

根據預設， Update-PSResource 安裝最新版本的套件及其任何相依性，而不需要刪除已安裝的舊版。 沒有命令可卸載舊版的套件。 您必須手動刪除舊版的檔案和資料夾。

Update-PSResource 不會將更新的模組載入目前的會話。 您必須匯入新版本，或啟動新的工作階段，才能使用更新的模組。 如需詳細資訊，請參閱 Import-Module。

範例

範例 1

在此範例中，用戶已安裝 TestModule 套件，並更新套件。

Get-PSResource -Name "TestModule"

Name                                    Version                         Prerelease   Description
----                                    -------                         ----------   -----------
TestModule                              1.2.0                                        test

Update-PSResource -Name "TestModule"

Name                                    Version                         Prerelease   Description
----                                    -------                         ----------   -----------
TestModule                              1.3.0                                        test
TestModule                              1.2.0                                        test

參數

-AcceptLicense

對於需要授權的資源， AcceptLicense 會在更新期間自動接受許可協定。

類型:SwitchParameter
Position:Named
預設值:False
必要:False
Accept pipeline input:False
Accept wildcard characters:False

-AuthenticodeCheck

驗證 Windows 上已簽署的檔案和目錄檔案。

類型:SwitchParameter
Position:Named
預設值:False
必要:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:SwitchParameter
Aliases:cf
Position:Named
預設值:False
必要:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

指定存取私人存放庫時所使用的選擇性認證。

類型:PSCredential
Position:Named
預設值:None
必要:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

指定時，會略過 TrustRepository 和 AcceptLicense 的檢查，並更新套件。

類型:SwitchParameter
Position:Named
預設值:False
必要:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

指定要更新的一或多個資源名稱。 支援通配符，但 NuGet 只接受 * 字元。 NuGet 不支援本機 （檔案型） 存放庫的通配符搜尋。

類型:String[]
Position:0
預設值:"*"
必要:False
Accept pipeline input:True
Accept wildcard characters:True

-PassThru

指定時，輸出 所儲存資源的 PSResourceInfo 物件。

類型:SwitchParameter
Position:Named
預設值:False
必要:False
Accept pipeline input:False
Accept wildcard characters:False

-Prerelease

指定時，允許更新至發行前版本。

類型:SwitchParameter
Position:Named
預設值:False
必要:False
Accept pipeline input:False
Accept wildcard characters:False

-Quiet

隱藏進度資訊。

類型:SwitchParameter
Position:Named
預設值:False
必要:False
Accept pipeline input:False
Accept wildcard characters:False

-Repository

指定要搜尋的一或多個存放庫名稱。 如果未指定，搜尋會依優先順序包含所有已註冊的存放庫（最高第一個），直到找到包含封裝的存放庫為止。 存放庫會依優先順序排序，然後依名稱排序。 優先順序較低的值具有較高的優先順序。

在多個存放庫之間搜尋資源時， PSResourceGet Cmdlet 會使用此排序順序來搜尋存放庫。 Update-PSResource 會從排序的存放庫清單中更新第一個相符的套件。

參數支援 * 通配符。 如果您指定多個存放庫，則所有名稱都必須包含或省略通配符。 您無法使用 通配符來指定名稱的混合。

類型:String[]
Position:Named
預設值:None
必要:False
Accept pipeline input:False
Accept wildcard characters:True

-Scope

指定安裝範圍。 接受的值包括：

  • CurrentUser
  • AllUsers

默認範圍是 CurrentUser，不需要提高許可權。

類型:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
接受的值:CurrentUser, AllUsers
Position:Named
預設值:None
必要:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipDependencyCheck

略過資源相依性的檢查。 這表示只會更新具名資源。

類型:SwitchParameter
Position:Named
預設值:False
必要:False
Accept pipeline input:False
Accept wildcard characters:False

-TemporaryPath

指定在實際 installatoin 之前暫時安裝資源的路徑。 如果未提供暫存路徑，資源會暫時安裝在目前使用者的暫存資料夾中。

類型:String
Position:Named
預設值:None
必要:False
Accept pipeline input:False
Accept wildcard characters:False

-TrustRepository

隱藏信任存放庫的提示。 只有在存放庫未設定為受信任時，才會發生信任存放庫的提示。

類型:SwitchParameter
Position:Named
預設值:False
必要:False
Accept pipeline input:False
Accept wildcard characters:False

-Version

指定要傳回的資源版本。 此值可以是使用 NuGet 版本設定語法的確切版本或版本範圍。

如需 NuGet 版本範圍的詳細資訊，請參閱 套件版本控制。

PowerShellGet 支援 NuGet 版本範圍檔中所列的最小內含版本。 使用 1.0.0.0 作為版本不會產生 1.0.0.0 版和更新版本（最小內含範圍）。 相反地，此值會被視為必要的版本。 若要搜尋最小內含範圍，請使用 [1.0.0.0, ] 作為版本範圍。

類型:String
Position:Named
預設值:None
必要:False
Accept pipeline input:False
Accept wildcard characters:True

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 Cmdlet 未執行。

類型:SwitchParameter
Aliases:wi
Position:Named
預設值:False
必要:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

String[]

輸出

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

根據預設，Cmdlet 不會傳回任何物件。 使用PassThru 參數時，Cmdlet 會輸出儲存資源的 PSResourceInfo 物件。

備註

模組會 udres 定義為的 Update-PSResource別名。