Compartir a través de

Uninstall-Package

  • Referencia
Módulo:
PackageManagement

Desinstala uno o varios paquetes de software.

Syntax

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

Description

El Uninstall-Package cmdlet desinstala uno o varios paquetes de software del equipo local. Para buscar paquetes instalados, use el Get-Package cmdlet .

Importante

Los comandos contenidos en el módulo PackageManagement son diferentes de los que proporciona el módulo NuGet en la consola del Administrador de paquetes de Visual Studio. Cada módulo tiene comandos que no están disponibles en el otro. Los comandos con el mismo nombre difieren en sus argumentos específicos. Para obtener más información, consulte la documentación de referencia de PowerShell para la consola del Administrador de paquetes de Visual Studio.

Ejemplos

Ejemplo 1: Desinstalar un paquete

El Uninstall-Package cmdlet desinstala los paquetes. El parámetro Name especifica el paquete que se va a desinstalar. Si se instalan varias versiones de un paquete, se desinstala la versión más reciente.

PS> Uninstall-Package -Name NuGet.Core

Ejemplo 2: Uso de la canalización para desinstalar un paquete

Get-Package busca un paquete específico y envía el objeto SoftwareIdentity a la canalización al Uninstall-Package cmdlet .

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

El Get-Package cmdlet usa los parámetros Name y RequiredVersion para especificar un paquete. Se envía un objeto SoftwareIdentity a la canalización. El Uninstall-Package cmdlet recibe el objeto como InputObject y quita el paquete.

Como alternativa, el Uninstall-Package cmdlet puede especificar un valor para el parámetro InputObject :

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

Parámetros

-AllowClobber

Invalida mensajes de advertencia sobre conflictos con comandos existentes. Sobrescribe los comandos existentes que tienen el mismo nombre que los comandos que se instalan.

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

-AllowPrereleaseVersions

Permite desinstalar los paquetes marcados como versión preliminar.

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

-AllVersions

Indica que este cmdlet desinstala todas las versiones del paquete.

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

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

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

-Destination

Especifica una cadena de la ruta de acceso al objeto de entrada.

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

-ExcludeVersion

Cambie para excluir el número de versión en la ruta de acceso de la carpeta.

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

-Force

Obliga al comando a ejecutarse sin solicitar la confirmación del usuario.

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

-ForceBootstrap

Obliga a PackageManagement a instalar automáticamente el proveedor de paquetes para el paquete especificado.

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

-InputObject

Acepta la entrada de canalización que especifica el objeto SoftwareIdentity del paquete del Get-Package cmdlet . InputObject acepta el objeto SoftwareIdentity como un Get-Package valor o una variable que contiene el objeto .

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

-InstallUpdate

Indica que Uninstall-Package desinstala las actualizaciones.

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

-MaximumVersion

Especifica la versión máxima permitida del paquete que desea desinstalar. Si no especifica este parámetro, Uninstall-Package desinstala la versión más reciente del paquete.

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

-MinimumVersion

Especifica la versión mínima permitida del paquete que desea desinstalar. Si no agrega este parámetro, Uninstall-Package desinstala la versión más reciente del paquete que satisface cualquier versión especificada por el parámetro MaximumVersion .

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

-Name

Especifica uno o varios nombres de paquete. Varios nombres de paquete deben estar separados por comas.

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

-NoPathUpdate

NoPathUpdate solo se aplica al Install-Script cmdlet . NoPathUpdate es un parámetro dinámico agregado por el proveedor y no es compatible con Uninstall-Package.

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

-PackageManagementProvider

Especifica el proveedor PackageManagement .

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

-ProviderName

Especifica uno o varios nombres de proveedor de paquetes para buscar paquetes. Puede obtener los nombres de proveedor del paquete mediante la ejecución del cmdlet 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

Especifica la versión exacta permitida del paquete que desea desinstalar. Si no agrega este parámetro, Uninstall-Package desinstala la versión más reciente del paquete que satisface cualquier versión especificada por el parámetro MaximumVersion .

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

-Scope

Especifica el ámbito para el que se va a desinstalar el paquete. Los valores aceptables para este parámetro son los siguientes:

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

-SkipDependencies

Omite la desinstalación de dependencias de software.

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

-SkipPublisherCheck

Permite obtener una versión de paquete más reciente que la versión instalada. Por ejemplo, un paquete instalado firmado digitalmente por un editor de confianza, pero una nueva versión no está firmada digitalmente.

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

-Type

Especifica si se deben buscar paquetes con un módulo, un script o ambos. Los valores aceptables para este parámetro son los siguientes:

  • módulo
  • Script
  • Todo
Type:String
Accepted values:Module, Script, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Muestra lo que sucedería si Uninstall-Package se ejecuta el cmdlet. El cmdlet no se ejecuta.

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

Entradas

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Puede canalizar objetos SoftwareIdentity a este cmdlet.

Salidas

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Este cmdlet devuelve un objeto SoftwareIdentity para cada paquete desinstalado.

Notas

Incluir un proveedor de paquetes en un comando puede hacer que los parámetros dinámicos estén disponibles para un cmdlet. Los parámetros dinámicos son específicos de un proveedor de paquetes. El Get-Help cmdlet enumera los conjuntos de parámetros de un cmdlet e incluye el conjunto de parámetros del proveedor. Por ejemplo, Uninstall-Package tiene establecido el parámetro PowerShellGet que incluye -NoPathUpdate, AllowClobbery SkipPublisherCheck.