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

Uninstall-Package

Модуль:
PackageManagement Module

Удаляет один или несколько пакетов программного обеспечения.

Синтаксис

PackageByInputObject 

Uninstall-Package
    [-InputObject] <SoftwareIdentity[]>
    [-AllVersions]
    [-Force]
    [-ForceBootstrap]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

PackageBySearch 

Uninstall-Package
    [-Name] <String[]>
    [-RequiredVersion <String>]
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-AllVersions]
    [-Force]
    [-ForceBootstrap]
    [-WhatIf]
    [-Confirm]
    [-ProviderName <String[]>]
    [<CommonParameters>]

NuGet:PackageByInputObject 

Uninstall-Package
    [-AllVersions]
    [-Force]
    [-ForceBootstrap]
    [-WhatIf]
    [-Confirm]
    [-Destination <String>]
    [-ExcludeVersion]
    [-Scope <String>]
    [-SkipDependencies]
    [<CommonParameters>]

NuGet:PackageBySearch 

Uninstall-Package
    [-AllVersions]
    [-Force]
    [-ForceBootstrap]
    [-WhatIf]
    [-Confirm]
    [-Destination <String>]
    [-ExcludeVersion]
    [-Scope <String>]
    [-SkipDependencies]
    [<CommonParameters>]

PowerShellGet:PackageByInputObject 

Uninstall-Package
    [-AllVersions]
    [-Force]
    [-ForceBootstrap]
    [-WhatIf]
    [-Confirm]
    [-Scope <String>]
    [-PackageManagementProvider <String>]
    [-Type <String>]
    [-AllowClobber]
    [-SkipPublisherCheck]
    [-InstallUpdate]
    [-NoPathUpdate]
    [-AllowPrereleaseVersions]
    [<CommonParameters>]

PowerShellGet:PackageBySearch 

Uninstall-Package
    [-AllVersions]
    [-Force]
    [-ForceBootstrap]
    [-WhatIf]
    [-Confirm]
    [-Scope <String>]
    [-PackageManagementProvider <String>]
    [-Type <String>]
    [-AllowClobber]
    [-SkipPublisherCheck]
    [-InstallUpdate]
    [-NoPathUpdate]
    [-AllowPrereleaseVersions]
    [<CommonParameters>]

Описание

Командлет Uninstall-Package удаляет один или несколько пакетов программного обеспечения с локального компьютера. Чтобы найти установленные пакеты, используйте командлет Get-Package.

Это важно

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

Примеры

Пример 1. Удаление пакета

Командлет Uninstall-Package удаляет пакеты. Параметр Name указывает пакет для удаления. Если установлены несколько версий пакета, удаляется последняя версия.

PS> Uninstall-Package -Name NuGet.Core

Пример 2. Удаление пакета с помощью конвейера

Get-Package находит определенный пакет и отправляет объект SoftwareIdentity вниз конвейера в командлет Uninstall-Package.

PS> Get-Package -Name NuGet.Core -RequiredVersion 2.14.0 | Uninstall-Package

Командлет использует параметры имени и RequiredVersion для указания пакета. Объект SoftwareIdentity отправляется по конвейеру. Командлет Uninstall-Package получает объект в виде inputObject и удаляет пакет.

В качестве альтернативы командлет Uninstall-Package может указать значение для параметра InputObject:

Uninstall-Package -InputObject ( Get-Package -Name NuGet.Core -RequiredVersion 2.14.0 )

Параметры

-AllowClobber

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

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

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

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

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

-AllowPrereleaseVersions

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

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

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

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

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

-AllVersions

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

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

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

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

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

-Confirm

Запрашивает подтверждение перед запуском cmdlet.

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

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

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

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

-Destination

Задает строку пути к входной объекту.

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

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

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

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

-ExcludeVersion

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

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

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

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

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

-Force

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

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

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

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

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

-ForceBootstrap

Принудительно PackageManagement автоматически установить поставщик пакетов для указанного пакета.

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

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

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

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

-InputObject

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

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

Тип:

Microsoft.PackageManagement.Packaging.SoftwareIdentity[]

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

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

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

-InstallUpdate

Указывает, что Uninstall-Package удаляет обновления.

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

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

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

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

-MaximumVersion

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

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

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

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

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

-MinimumVersion

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

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

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

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

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

-Name

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

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

Тип:

String[]

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

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

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

-NoPathUpdate

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

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

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

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

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

-PackageManagementProvider

Указывает поставщик PackageManagement.

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

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

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

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

-ProviderName

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

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

Тип:

String[]

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

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

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

-RequiredVersion

Указывает точную разрешенную версию пакета, которую требуется удалить. Если этот параметр не добавлен, Uninstall-Package удаляет последнюю версию пакета, которая удовлетворяет любой версии, указанной параметром MaximumVersion.

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

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

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

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

-Scope

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

  • Текущий пользователь
  • ВсеПользователи

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

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

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

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

-SkipDependencies

Пропускает удаление зависимостей программного обеспечения.

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

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

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

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

-SkipPublisherCheck

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

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

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

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

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

-Type

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

  • Модуль
  • Сценарий
  • Все

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

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

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

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

-WhatIf

Показывает, что произойдет, если выполняется командлет Uninstall-Package. Командлет не выполняется.

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

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

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

(All)
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 можно передать в этот командлет.

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

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Этот командлет возвращает объект SoftwareIdentity для каждого пакета, удаленного.

Примечания

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