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


Uninstall-Package

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

Синтаксис

Uninstall-Package
         [-InputObject] <SoftwareIdentity[]>
         [-AllVersions]
         [-Force]
         [-ForceBootstrap]
         [-WhatIf]
         [-Confirm]
         [<CommonParameters>]
Uninstall-Package
         [-Name] <String[]>
         [-RequiredVersion <String>]
         [-MinimumVersion <String>]
         [-MaximumVersion <String>]
         [-AllVersions]
         [-Force]
         [-ForceBootstrap]
         [-WhatIf]
         [-Confirm]
         [-ProviderName <String[]>]
         [<CommonParameters>]
Uninstall-Package
         [-AllVersions]
         [-Force]
         [-ForceBootstrap]
         [-WhatIf]
         [-Confirm]
         [-Destination <String>]
         [-ExcludeVersion]
         [-Scope <String>]
         [-SkipDependencies]
         [<CommonParameters>]
Uninstall-Package
         [-AllVersions]
         [-Force]
         [-ForceBootstrap]
         [-WhatIf]
         [-Confirm]
         [-Destination <String>]
         [-ExcludeVersion]
         [-Scope <String>]
         [-SkipDependencies]
         [<CommonParameters>]
Uninstall-Package
         [-AllVersions]
         [-Force]
         [-ForceBootstrap]
         [-WhatIf]
         [-Confirm]
         [-Scope <String>]
         [-PackageManagementProvider <String>]
         [-Type <String>]
         [-AllowClobber]
         [-SkipPublisherCheck]
         [-InstallUpdate]
         [-NoPathUpdate]
         [-AllowPrereleaseVersions]
         [<CommonParameters>]
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

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

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

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

Параметры

-AllowClobber

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

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

-AllowPrereleaseVersions

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

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

-AllVersions

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

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

-Confirm

Запрос подтверждения перед выполнением командлета.

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

-Destination

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

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

-ExcludeVersion

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

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

-Force

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

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

-ForceBootstrap

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

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

-InputObject

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

Type:Microsoft.PackageManagement.Packaging.SoftwareIdentity[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-InstallUpdate

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

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

-MaximumVersion

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

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

-MinimumVersion

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

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

-Name

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

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

-NoPathUpdate

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

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

-PackageManagementProvider

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

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

-ProviderName

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

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

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

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

-Scope

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

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

-SkipDependencies

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

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

-SkipPublisherCheck

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

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

-Type

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

  • Модуль
  • Скрипт
  • Все
Type:String
Accepted values:Module, Script, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

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

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

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Вы можете передать объекты SoftwareIdentity в этот командлет.

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

Microsoft.PackageManagement.Packaging.SoftwareIdentity

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

Примечания

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