Get-Package
傳回隨 PackageManagement一起安裝的所有軟體套件清單。
Syntax
Get-Package
[[-Name] <String[]>]
[-RequiredVersion <String>]
[-MinimumVersion <String>]
[-MaximumVersion <String>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-ProviderName <String[]>]
[-Destination <String>]
[-ExcludeVersion]
[-Scope <String>]
[-SkipDependencies]
[<CommonParameters>]
Get-Package
[[-Name] <String[]>]
[-RequiredVersion <String>]
[-MinimumVersion <String>]
[-MaximumVersion <String>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-ProviderName <String[]>]
[-Scope <String>]
[-PackageManagementProvider <String>]
[-Type <String>]
[-AllowClobber]
[-SkipPublisherCheck]
[-InstallUpdate]
[-NoPathUpdate]
[-AllowPrereleaseVersions]
[<CommonParameters>]
Description
Cmdlet Get-Package
會傳回隨 PackageManagement一起安裝之本機電腦上所有軟體套件的清單。 您可以在遠端電腦上執行 Get-Package
,方法是將其執行為 或 Enter-PSSession
命令或腳本的一 Invoke-Command
部分。
重要
PackageManagement模組中包含的命令與 Visual Studio 套件管理員主控台中NuGet模組所提供的命令不同。 每個模組都有其他模組中無法使用的命令。 具有相同名稱的命令與其特定引數不同。 如需詳細資訊,請參閱 Visual Studio 套件管理員主控台的 PowerShell 參考 檔。
範例
範例 1:取得所有已安裝的套件
Cmdlet Get-Package
會取得安裝在本機電腦上的所有套件。
Get-Package
Name Version Source ProviderName
---- ------- ------ ------------
posh-git 0.7.3 https://www.powershellgallery.com/api/v2 PowerShellGet
範例 2:取得安裝在遠端電腦上的套件
此命令會取得遠端電腦上 PackageManagement 所安裝的套件清單。 此命令會提示您提供指定的使用者密碼。
PS> Invoke-Command -ComputerName Server01 -Credential CONTOSO\TestUser -ScriptBlock {Get-Package}
Invoke-Command
會使用 ComputerName 參數來指定遠端電腦 Server01。 Credential參數會指定具有在電腦上執行命令許可權的網域和使用者名稱。 ScriptBlock參數會在 Get-Package
遠端電腦上執行 Cmdlet。
範例 3:取得指定提供者的套件
此命令會從特定提供者取得安裝在本機電腦上的軟體套件。
Get-Package -ProviderName PowerShellGet -AllVersions
Name Version Source ProviderName
---- ------- ------ ------------
PackageManagement 1.2.2 https://www.powershellgallery.com/api/v2 PowerShellGet
PackageManagement 1.3.1 https://www.powershellgallery.com/api/v2 PowerShellGet
posh-git 0.7.3 https://www.powershellgallery.com/api/v2 PowerShellGet
PowerShellGet 2.0.1 https://www.powershellgallery.com/api/v2 PowerShellGet
Get-Package
會使用 ProviderName 參數來指定特定提供者 PowerShellGet。
AllVersions參數會顯示已安裝的每個版本。
範例 4:取得特定套件的確切版本
此命令會取得已安裝套件的特定版本。 可以安裝多個版本的套件。
Get-Package -Name PackageManagement -ProviderName PowerShellGet -RequiredVersion 1.3.1
Name Version Source ProviderName
---- ------- ------ ------------
PackageManagement 1.3.1 https://www.powershellgallery.com/api/v2 PowerShellGet
Get-Package
會使用 Name 參數來指定封裝名稱 PackageManagement。 ProviderName參數會指定提供者PowerShellGet。 RequiredVersion參數會指定已安裝的版本。
範例 5:卸載套件
此範例會取得套件資訊,然後卸載套件。
Get-Package -Name posh-git -RequiredVersion 0.7.3 | Uninstall-Package
Get-Package
會使用 Name 參數來指定套件名稱 posh-git。 RequiredVersion參數是套件的特定版本。 物件會從管線向下傳送至 Uninstall-Package
Cmdlet。 Uninstall-Package
移除封裝。
參數
-AllowClobber
覆寫與現有命令衝突的相關警告訊息。 覆寫與模組所安裝命令同名的現有命令。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowPrereleaseVersions
在結果中包含標示為發行前版本的套件。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllVersions
表示傳 Get-Package
回套件的所有可用版本。 根據預設, Get-Package
只會傳回最新的可用版本。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Destination
指定包含解壓縮封裝檔案之目錄的路徑。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcludeVersion
切換以排除資料夾路徑中的版本號碼。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
強制執行命令而不要求使用者確認。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceBootstrap
Get-Package
表示強制PackageManagement自動安裝套件提供者。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstallUpdate
指出此 Cmdlet 會安裝更新。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaximumVersion
指定您想要尋找的套件版本上限。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MinimumVersion
指定您想要尋找的最低套件版本。 如果可用的版本較高,則會傳回該版本。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
指定一或多個套件名稱,或具有萬用字元的封裝名稱。 以逗號分隔多個封裝名稱。
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-NoPathUpdate
NoPathUpdate 僅適用于 Install-Script
Cmdlet。 NoPathUpdate 是由提供者新增的動態參數,不支援 Get-Package
。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PackageManagementProvider
指定封裝管理提供者的名稱。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProviderName
指定一或多個套件提供者名稱。 以逗號分隔多個套件提供者名稱。
用來 Get-PackageProvider
取得可用套件提供者的清單。
Type: | String[] |
Aliases: | Provider |
Accepted values: | Bootstrap, NuGet, PowerShellGet |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RequiredVersion
指定要尋找之套件的確切版本。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Scope
指定封裝的搜尋範圍。
Type: | String |
Accepted values: | CurrentUser, AllUsers |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkipDependencies
參數,指定略過尋找任何套件相依性。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkipPublisherCheck
可讓您取得比已安裝版本還新的套件版本。 例如,由信任的發行者以數位方式簽署但未數位簽署新版本的已安裝套件。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Type
指定是否要搜尋具有模組、腳本或任一項的套件。
Type: | String |
Accepted values: | Module, Script, All |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸出
Microsoft.PackageManagement.Packaging.SoftwareIdentity
此 Cmdlet 會針對符合參數的每個已安裝套件傳回 SoftwareIdentity 物件。 根據預設,它會傳回每個已安裝的套件。
備註
在命令中包含套件提供者,可讓 Cmdlet 使用動態參數。 動態參數是套件提供者特有的。 Cmdlet Get-Help
會列出 Cmdlet 的參數集,並包含提供者的參數集。 例如, Get-Package
具有包含 、 AllowClobber
和 SkipPublisherCheck
的PowerShellGet參數集 -NoPathUpdate
。
重要
從 2020 年 4 月起,PowerShell 資源庫已不再支援傳輸層安全性 (TLS) 1.0 和 1.1 版。 如果您不是使用 TLS 1.2 或更高版本,您在嘗試存取 PowerShell 資源庫時將會收到錯誤。 使用下列命令來確保您使用的是 TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
如需詳細資訊,請參閱 PowerShell 部落格中的公告 \(英文\)。