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
, AllowClobber
y SkipPublisherCheck
.