Поделиться через


Get-Package

Возвращает список всех пакетов программного обеспечения, установленных с помощью PackageManagement.

Синтаксис

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

Описание

Командлет Get-Package возвращает список всех пакетов программного обеспечения на локальном компьютере, установленных с помощью PackageManagement. Вы можете запускать Get-Package на удаленных компьютерах, выполняя его как часть Invoke-Command или команду или Enter-PSSession скрипт.

Это важно

Команды, содержащиеся в модуле PackageManagement , отличаются от команд, предоставляемых модулем NuGet в консоли диспетчера пакетов Visual Studio. Каждый модуль имеет команды, недоступные в другом. Команды с одинаковым именем отличаются в их конкретных аргументах. Дополнительные сведения см. в справочной документации по PowerShell для консоли диспетчера пакетов Visual Studio.

Примеры

Пример 1. Получение всех установленных пакетов

Командлет 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 командлет на удаленном компьютере.

Пример 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 . Uninstall-Package удаляет пакет.

Параметры

-AllowClobber

Переопределяет предупреждения о конфликтах с существующими командами. Перезаписывает существующие команды с тем же именем, что и команды, установленные модулем.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AllowPrereleaseVersions

Включает пакеты, помеченные как предварительная версия в результатах.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AllVersions

Указывает, что Get-Package возвращает все доступные версии пакета. По умолчанию Get-Package возвращается только самая новая доступная версия.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Destination

Указывает путь к каталогу, содержаму извлеченные файлы пакета.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ExcludeVersion

Переключитесь, чтобы исключить номер версии в пути к папке.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Force

Принудительно выполняется команда без запроса подтверждения пользователя.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ForceBootstrap

Указывает, что Get-PackageпакетManagement принудительно устанавливает поставщик пакетов автоматически.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-InstallUpdate

Указывает, что этот командлет устанавливает обновления.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-MaximumVersion

Указывает максимальную версию пакета, которую требуется найти.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-MinimumVersion

Указывает минимальную версию пакета, которую требуется найти. Если доступна более поздняя версия, возвращается эта версия.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Name

Задает одно или несколько имен пакетов или имен пакетов с подстановочными знаками. Разделите несколько имен пакетов запятыми.

Тип:String[]
Position:0
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:True

-NoPathUpdate

NoPathUpdate применяется только к командлету Install-Script . NoPathUpdate — это динамический параметр, добавленный поставщиком и не поддерживается Get-Package.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-PackageManagementProvider

Указывает имя поставщика управления пакетами.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ProviderName

Указывает одно или несколько имен поставщиков пакетов. Разделите несколько имен поставщиков пакетов запятыми. Используется Get-PackageProvider для получения списка доступных поставщиков пакетов.

Тип:String[]
Aliases:Provider
Допустимые значения:Bootstrap, NuGet, PowerShellGet
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-RequiredVersion

Указывает точную версию пакета для поиска.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Scope

Указывает область поиска для пакета.

Тип:String
Допустимые значения:CurrentUser, AllUsers
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SkipDependencies

Переключатель, указывающий, чтобы пропустить поиск зависимостей пакета.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SkipPublisherCheck

Позволяет получить версию пакета, которая является более новой, чем установленная версия. Например, установленный пакет, подписанный доверенным издателем, но новая версия не подписана цифровой подписью.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Type

Указывает, следует ли искать пакеты с помощью модуля, скрипта или одного из этих пакетов.

Тип:String
Допустимые значения:Module, Script, All
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Выходные данные

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Этот командлет возвращает объект SoftwareIdentity для каждого установленного пакета, соответствующего параметрам. По умолчанию он возвращает каждый установленный пакет.

Примечания

Включение поставщика пакетов в команду может сделать динамические параметры доступными для командлета. Динамические параметры относятся к поставщику пакетов. Командлет Get-Help перечисляет наборы параметров командлета и включает набор параметров поставщика. Например, Get-Package имеет набор параметров PowerShellGet , включающий -NoPathUpdate, AllowClobberи SkipPublisherCheck.

Это важно

По состоянию на апрель 2020 г. коллекция PowerShell больше не поддерживает протокол TLS версии 1.0 и 1.1. Если вы не используете TLS 1.2 или более поздней версии, при попытке получить доступ к коллекции PowerShell появится сообщение об ошибке. Используйте следующую команду, чтобы убедиться, что используется TLS 1.2:

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

Дополнительные сведения см. в объявления в блоге PowerShell.