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
.
Связанные ссылки
PowerShellGet