Compartir a través de


Uninstall-Package

Desinstala uno o varios paquetes de software.

Sintaxis

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 comandos proporcionados por 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. Un objeto SoftwareIdentity se envía 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.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AllowPrereleaseVersions

Permite desinstalar los paquetes marcados como versión preliminar.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AllVersions

Indica que este cmdlet desinstala todas las versiones del paquete.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Destination

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

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ExcludeVersion

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Force

Obliga a que el comando se ejecute sin pedir confirmación del usuario.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ForceBootstrap

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 .

Tipo:Microsoft.PackageManagement.Packaging.SoftwareIdentity[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-InstallUpdate

Indica que Uninstall-Package desinstala las actualizaciones.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 .

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

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

Tipo:String[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PackageManagementProvider

Especifica el proveedor PackageManagement .

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ProviderName

Especifica uno o varios nombres de proveedor de paquetes para buscar paquetes. Para obtener los nombres de proveedor de paquetes, ejecute el Get-PackageProvider cmdlet .

Tipo:String[]
Alias:Provider
Valores aceptados:Bootstrap, NuGet, PowerShellGet
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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 .

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Scope

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

  • UsuarioActual
  • AllUsers
Tipo:String
Valores aceptados:CurrentUser, AllUsers
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SkipDependencies

Omite la desinstalación de dependencias de software.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 publicador de confianza, pero una nueva versión no está firmada digitalmente.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Type

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

  • Módulo
  • Guión
  • Todos
Tipo:String
Valores aceptados:Module, Script, All
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.