Get-Package

Modul:

PackageManagement Module

Vrátí seznam všech softwarových balíčků, které byly nainstalovány pomocí PackageManagement.

Syntaxe

NuGet

Get-Package
    [[-Name] <String[]>]
    [-RequiredVersion <String>]
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-AllVersions]
    [-Force]
    [-ForceBootstrap]
    [-ProviderName <String[]>]
    [-Destination <String>]
    [-ExcludeVersion]
    [-Scope <String>]
    [-SkipDependencies]
    [<CommonParameters>]

PowerShellGet

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. Get-Package můžete spustit na vzdálených počítačích spuštěním jako součást Invoke-Command nebo Enter-PSSession příkazu nebo 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 jejich konkrétních argumentech. Další informace najdete v referenční dokumentaci 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í zadaného hesla 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í na vzdáleném počítači rutinu Get-Package.

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

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

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. Lze 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 určení 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 získá informace o balíčku a pak balíček odinstaluje.

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

Get-Package používá 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 do rutiny Uninstall-Package. Uninstall-Package balíček odebere.

Parametry

-AllowClobber

Přepíše zprávy upozornění týkající se konfliktů s existujícími příkazy. Přepíše existující příkazy, které mají stejný název jako příkazy nainstalované modulem.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

PowerShellGet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-AllowPrereleaseVersions

Obsahuje balíčky označené jako předběžné verze ve výsledcích.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

PowerShellGet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-AllVersions

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Destination

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

NuGet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ExcludeVersion

Přepněte na vyloučení čísla verze v cestě ke složce.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

NuGet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Force

Přinutí příkaz ke spuštění bez výzvy k potvrzení uživatele.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ForceBootstrap

Označuje, že Get-Package vynutí PackageManagement automaticky nainstalovat zprostředkovatele balíčku.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-InstallUpdate

Označuje, že tato rutina instaluje aktualizace.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

PowerShellGet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-MaximumVersion

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-MinimumVersion

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	True
DontShow:	False

Sady parametrů

(All)

Position:	0
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-NoPathUpdate

NoPathUpdate se vztahuje pouze na rutinu Install-Script . NoPathUpdate je dynamický parametr přidaný poskytovatelem a není podporován Get-Package.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

PowerShellGet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-PackageManagementProvider

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

PowerShellGet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ProviderName

Určuje jeden nebo více názvů zprostředkovatelů balíčků. Oddělte více názvů zprostředkovatelů balíčků čárkami. Seznam dostupných poskytovatelů balíčků získáte pomocí Get-PackageProvider.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Přípustné hodnoty:	Bootstrap, NuGet, PowerShellGet
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Poskytovatel

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-RequiredVersion

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Scope

Určuje obor vyhledávání balíčku.

Vlastnosti parametru

Typ:	String
Default value:	None
Přípustné hodnoty:	CurrentUser, AllUsers
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-SkipDependencies

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

NuGet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-SkipPublisherCheck

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

PowerShellGet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Type

Určuje, jestli se mají hledat balíčky s modulem, skriptem nebo některou z těchto.

Vlastnosti parametru

Typ:	String
Default value:	None
Přípustné hodnoty:	Module, Script, All
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

PowerShellGet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

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í každý nainstalovaný balíček.

Poznámky

Zahrnutí zprostředkovatele balíčku do příkazu může zpřístupnit dynamické parametry rutině. Dynamické parametry jsou specifické pro zprostředkovatele balíčku. Rutina Get-Help obsahuje sady parametrů rutiny a zahrnuje sadu parametrů poskytovatele. 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 vyšší, při pokusu o přístup k galerii 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 oznámení v blogu PowerShellu.

Související odkazy

• about_SprávaBalíčků
• Příkaz Enter-PSSession
• Find-Package
• Získat nápovědu
• Get-PackageProvider
• Get-PackageSource
• Install-Package
• Invoke-Command
• Save-Package
• Odebrat-Balíček