Sdílet prostřednictvím

Get-Package

  • Reference
Modul:
PackageManagement

Vrátí seznam všech softwarových balíčků, které byly nainstalovány pomocí 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

Rutina Get-Package vrátí seznam všech softwarových balíčků v místním počítači, které byly nainstalovány s PackageManagement. Na vzdálených počítačích můžete spustit Get-Package jako součást Invoke-Command příkazu nebo Enter-PSSession skriptu.

Důležité

Příkazy obsažené v modulu PackageManagement se liší od příkazů poskytovaných modulem NuGet v konzole Správce balíčků sady Visual Studio. Každý modul obsahuje příkazy, které nejsou k dispozici v druhém modulu. Příkazy se stejným názvem se liší v konkrétních argumentech. Další informace najdete v referenční dokumentaci k PowerShellu pro konzolu Správce balíčků sady Visual Studio.

Příklady

Příklad 1: Získání všech nainstalovaných balíčků

Rutina Get-Package získá všechny balíčky nainstalované v místním počítači.

Get-Package

Name           Version      Source                                     ProviderName
----           -------      ------                                     ------------
posh-git       0.7.3        https://www.powershellgallery.com/api/v2   PowerShellGet

Příklad 2: Získání balíčků nainstalovaných ve vzdáleném počítači

Tento příkaz získá seznam balíčků, které byly nainstalovány PackageManagement na vzdáleném počítači. Tento příkaz vás vyzve k zadání hesla zadaného uživatele.

PS> Invoke-Command -ComputerName Server01 -Credential CONTOSO\TestUser -ScriptBlock {Get-Package}

Invoke-Command používá parametr ComputerName k určení vzdáleného počítače Server01. Parametr Credential určuje doménu a uživatelské jméno s oprávněními ke spouštění příkazů v počítači. Parametr ScriptBlock spustí rutinu Get-Package na vzdáleném počítači.

Příklad 3: Získání balíčků pro zadaného zprostředkovatele

Tento příkaz získá softwarové balíčky nainstalované v místním počítači od konkrétního zprostředkovatele.

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 používá parametr ProviderName k určení konkrétního zprostředkovatele , PowerShellGet. Parametr AllVersions zobrazí každou nainstalovanou verzi.

Příklad 4: Získání přesné verze konkrétního balíčku

Tento příkaz získá konkrétní verzi nainstalovaného balíčku. Je možné nainstalovat více než jednu verzi balíčku.

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 používá parametr Name k zadání názvu balíčku PackageManagement. Parametr ProviderName určuje zprostředkovatele , PowerShellGet. Parametr RequiredVersion určuje nainstalovanou verzi.

Příklad 5: Odinstalace balíčku

Tento příklad načte informace o balíčku a poté balíček odinstaluje.

Get-Package -Name posh-git -RequiredVersion 0.7.3 | Uninstall-Package

Get-Package použije parametr Name k zadání názvu balíčku posh-git. Parametr RequiredVersion je konkrétní verze balíčku. Objekt se odešle do kanálu rutiny Uninstall-Package . Uninstall-Package odebere balíček.

Parametry

-AllowClobber

Přepíše upozornění na konflikty s existujícími příkazy. Přepíše existující příkazy, které mají stejný název jako příkazy instalované modulem.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowPrereleaseVersions

Zahrne do výsledků balíčky označené jako předběžné verze.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllVersions

Označuje, že Get-Package vrátí všechny dostupné verze balíčku. Ve výchozím nastavení Get-Package vrátí jenom nejnovější dostupnou verzi.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Destination

Určuje cestu k adresáři, který obsahuje extrahované soubory balíčků.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcludeVersion

Přepnutím vyloučíte číslo verze v cestě ke složce.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Vynutí spuštění příkazu bez žádosti o potvrzení uživatele.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceBootstrap

Označuje, že Get-Packagevynutí, aby PackageManagement automaticky nainstaloval zprostředkovatele balíčku.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InstallUpdate

Označuje, že tato rutina instaluje aktualizace.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaximumVersion

Určuje maximální verzi balíčku, kterou chcete najít.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MinimumVersion

Určuje minimální verzi balíčku, kterou chcete najít. Pokud je k dispozici vyšší verze, vrátí se tato verze.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Určuje jeden nebo více názvů balíčků nebo názvy balíčků se zástupnými znaky. Více názvů balíčků oddělte čárkami.

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-NoPathUpdate

NoPathUpdate se vztahuje pouze na rutinu Install-Script . NoPathUpdate je dynamický parametr přidaný zprostředkovatelem a nepodporuje ho Get-Package.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PackageManagementProvider

Určuje název zprostředkovatele správy balíčků.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProviderName

Určuje jeden nebo více názvů zprostředkovatelů balíčků. Více názvů poskytovatelů balíčků oddělte čárkami. Pomocí Get-PackageProvider příkazu získáte seznam dostupných poskytovatelů balíčků.

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

Určuje přesnou verzi balíčku, který se má najít.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Scope

Určuje obor vyhledávání pro balíček.

Type:String
Accepted values:CurrentUser, AllUsers
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipDependencies

Přepínač, který určuje, že se má přeskočit hledání závislostí balíčků.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipPublisherCheck

Umožňuje získat verzi balíčku, která je novější než nainstalovaná verze. Například nainstalovaný balíček, který je digitálně podepsaný důvěryhodným vydavatelem, ale není digitálně podepsaný novou verzí.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Type

Určuje, jestli se mají vyhledat balíčky pomocí modulu, skriptu nebo některého z těchto modulů.

Type:String
Accepted values:Module, Script, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Výstupy

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Tato rutina vrátí objekt SoftwareIdentity pro každý nainstalovaný balíček, který odpovídá parametrům. Ve výchozím nastavení vrátí všechny nainstalované balíčky.

Poznámky

Zahrnutí poskytovatele balíčku do příkazu může rutině zpřístupnit dynamické parametry. Dynamické parametry jsou specifické pro zprostředkovatele balíčku. Rutina Get-Help vypíše sady parametrů rutiny a zahrne sadu parametrů zprostředkovatele. Má například Get-Package sadu parametrů PowerShellGet , která zahrnuje -NoPathUpdate, AllowClobbera SkipPublisherCheck.

Důležité

Od dubna 2020 Galerie prostředí PowerShell už nepodporuje protokol TLS (Transport Layer Security) verze 1.0 a 1.1. Pokud nepoužíváte protokol TLS 1.2 nebo novější, při pokusu o přístup k Galerie prostředí PowerShell se zobrazí chyba. Pomocí následujícího příkazu se ujistěte, že používáte protokol TLS 1.2:

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

Další informace najdete v tomto oznámení na blogu o PowerShellu.