Udostępnij za pośrednictwem

Get-Package

  • Odwołanie
Moduł:
PackageManagement

Zwraca listę wszystkich pakietów oprogramowania, które zostały zainstalowane z pakietem PackageManagement.

Składnia

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>]

Opis

Polecenie Get-Package cmdlet zwraca listę wszystkich pakietów oprogramowania na komputerze lokalnym, które zostały zainstalowane z pakietem PackageManagement. Można uruchomić Get-Package na komputerach zdalnych, uruchamiając go w ramach Invoke-Command polecenia lub Enter-PSSession skryptu lub polecenia.

Ważne

Polecenia zawarte w module PackageManagement różnią się od poleceń udostępnianych przez moduł NuGet w konsoli Menedżera pakietów programu Visual Studio. Każdy moduł zawiera polecenia, które nie są dostępne w drugiej. Polecenia o tej samej nazwie różnią się w swoich konkretnych argumentach. Aby uzyskać więcej informacji, zobacz dokumentację referencyjną programu PowerShell dla konsoli Menedżera pakietów programu Visual Studio.

Przykłady

Przykład 1. Pobieranie wszystkich zainstalowanych pakietów

Polecenie Get-Package cmdlet pobiera wszystkie pakiety zainstalowane na komputerze lokalnym.

Get-Package

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

Przykład 2. Pobieranie pakietów zainstalowanych na komputerze zdalnym

To polecenie pobiera listę pakietów zainstalowanych przez pakietManagement na komputerze zdalnym. To polecenie wyświetla monit o podanie hasła określonego użytkownika.

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

Invoke-Command używa parametru ComputerName , aby określić komputer zdalny Server01. Parametr Credential określa domenę i nazwę użytkownika z uprawnieniami do uruchamiania poleceń na komputerze. Parametr ScriptBlock uruchamia Get-Package polecenie cmdlet na komputerze zdalnym.

Przykład 3. Pobieranie pakietów dla określonego dostawcy

To polecenie pobiera pakiety oprogramowania zainstalowane na komputerze lokalnym od określonego dostawcy.

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 używa parametru ProviderName , aby określić określonego dostawcę, PowerShellGet. Parametr AllVersions wyświetla każdą zainstalowaną wersję.

Przykład 4. Pobieranie dokładnej wersji określonego pakietu

To polecenie pobiera określoną wersję zainstalowanego pakietu. Można zainstalować więcej niż jedną wersję pakietu.

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 używa parametru Name , aby określić nazwę pakietu PackageManagement. Parametr ProviderName określa dostawcę, PowerShellGet. Parametr RequiredVersion określa zainstalowaną wersję.

Przykład 5. Odinstalowywanie pakietu

Ten przykład pobiera informacje o pakiecie, a następnie odinstalowuje pakiet.

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

Get-Package używa parametru Name , aby określić nazwę pakietu posh-git. Parametr RequiredVersion jest określoną wersją pakietu. Obiekt jest wysyłany w dół potoku Uninstall-Package do polecenia cmdlet. Uninstall-Package usuwa pakiet.

Parametry

-AllowClobber

Zastępuje komunikaty ostrzegawcze dotyczące konfliktów z istniejącymi poleceniami. Zastępuje istniejące polecenia, które mają taką samą nazwę jak polecenia instalowane przez moduł.

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

-AllowPrereleaseVersions

Zawiera pakiety oznaczone jako wersję wstępną w wynikach.

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

-AllVersions

Wskazuje, że Get-Package zwraca wszystkie dostępne wersje pakietu. Domyślnie Get-Package zwraca tylko najnowszą dostępną wersję.

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

-Destination

Określa ścieżkę do katalogu zawierającego wyodrębnione pliki pakietów.

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

-ExcludeVersion

Przełącz się, aby wykluczyć numer wersji w ścieżce folderu.

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

-Force

Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.

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

-ForceBootstrap

Wskazuje, że wymusza ustawienie Get-PackagePackageManagement w celu automatycznego instalowania dostawcy pakietów.

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

-InstallUpdate

Wskazuje, że to polecenie cmdlet instaluje aktualizacje.

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

-MaximumVersion

Określa maksymalną wersję pakietu, którą chcesz znaleźć.

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

-MinimumVersion

Określa minimalną wersję pakietu, którą chcesz znaleźć. Jeśli dostępna jest wyższa wersja, zwracana jest ta wersja.

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

-Name

Określa co najmniej jedną nazwę pakietu lub nazwy pakietów z symbolami wieloznacznymi. Rozdziel wiele nazw pakietów przecinkami.

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

-NoPathUpdate

NoPathUpdate dotyczy Install-Script tylko polecenia cmdlet. NoPathUpdate jest parametrem dynamicznym dodanym przez dostawcę i nie jest obsługiwany przez Get-Packageprogram .

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

-PackageManagementProvider

Określa nazwę dostawcy zarządzania pakietami.

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

-ProviderName

Określa co najmniej jedną nazwę dostawcy pakietów. Rozdziel wiele nazw dostawców pakietów przecinkami. Użyj Get-PackageProvider polecenia , aby uzyskać listę dostępnych dostawców pakietów.

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

Określa dokładną wersję pakietu do znalezienia.

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

-Scope

Określa zakres wyszukiwania pakietu.

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

-SkipDependencies

Przełącznik określający, aby pominąć znajdowanie wszystkich zależności pakietu.

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

-SkipPublisherCheck

Umożliwia pobranie wersji pakietu nowszej niż zainstalowana wersja. Na przykład zainstalowany pakiet podpisany cyfrowo przez zaufanego wydawcę, ale nowa wersja nie jest podpisana cyfrowo.

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

-Type

Określa, czy należy wyszukiwać pakiety za pomocą modułu, skryptu, czy też.

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

Dane wyjściowe

Microsoft.PackageManagement.Packaging.SoftwareIdentity

To polecenie cmdlet zwraca obiekt SoftwareIdentity dla każdego zainstalowanego pakietu zgodnego z parametrami. Domyślnie zwraca każdy zainstalowany pakiet.

Uwagi

Dołączenie dostawcy pakietów w poleceniu może udostępnić parametry dynamiczne do polecenia cmdlet. Parametry dynamiczne są specyficzne dla dostawcy pakietów. Polecenie Get-Help cmdlet wyświetla zestawy parametrów polecenia cmdlet i zawiera zestaw parametrów dostawcy. Na przykład Get-Package zestaw parametrów PowerShellGet , który zawiera -NoPathUpdate, AllowClobberi SkipPublisherCheck.

Ważne

Od kwietnia 2020 r. Galeria programu PowerShell nie obsługuje już protokołu Transport Layer Security (TLS) w wersji 1.0 i 1.1. Jeśli nie używasz protokołu TLS 1.2 lub nowszego, podczas próby uzyskania dostępu do Galeria programu PowerShell zostanie wyświetlony błąd. Użyj następującego polecenia, aby upewnić się, że używasz protokołu TLS 1.2:

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

Aby uzyskać więcej informacji, zobacz ogłoszenie w blogu programu PowerShell.