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


Get-Package

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

Синтаксис

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

Описание

Командлет 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. Параметр учетных данных указывает домен и имя пользователя с разрешениями на выполнение команд на компьютере. Параметр scriptBlock запускает командлет на удаленном компьютере.

Пример 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

использует параметр имени для указания имени пакета 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
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

PowerShellGet
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-AllowPrereleaseVersions

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

PowerShellGet
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-AllVersions

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Destination

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

NuGet
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ExcludeVersion

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

NuGet
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Force

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ForceBootstrap

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-InstallUpdate

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

PowerShellGet
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-MaximumVersion

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-MinimumVersion

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Name

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

Свойства параметра

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:True
DontShow:False

Наборы параметров

(All)
Position:0
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-NoPathUpdate

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

PowerShellGet
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-PackageManagementProvider

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

PowerShellGet
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ProviderName

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

Свойства параметра

Тип:

String[]

Default value:None
Допустимые значения:Bootstrap, NuGet, PowerShellGet
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Поставщик

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-RequiredVersion

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Scope

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

Свойства параметра

Тип:String
Default value:None
Допустимые значения:CurrentUser, AllUsers
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-SkipDependencies

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

NuGet
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-SkipPublisherCheck

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

PowerShellGet
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Type

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

Свойства параметра

Тип:String
Default value:None
Допустимые значения:Module, Script, All
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

PowerShellGet
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

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.