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
Дополнительные сведения см. в объявления