Partilhar via

Uninstall-Package

  • Referência
Módulo:
PackageManagement

Desinstala um ou mais pacotes 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

O Uninstall-Package cmdlet desinstala um ou mais pacotes de software do computador local. Para localizar pacotes instalados, utilize o Get-Package cmdlet .

Importante

Os comandos contidos no módulo PackageManagement são diferentes dos comandos fornecidos pelo módulo NuGet na Consola do Gestor de Pacotes do Visual Studio. Cada módulo tem comandos que não estão disponíveis no outro. Os comandos com o mesmo nome diferem nos respetivos argumentos específicos. Para obter mais informações, veja a documentação de referência do PowerShell para a Consola do Gestor de Pacotes do Visual Studio.

Exemplos

Exemplo 1: Desinstalar um pacote

O Uninstall-Package cmdlet desinstala pacotes. O parâmetro Name especifica o pacote a desinstalar. Se estiverem instaladas várias versões de um pacote, a versão mais recente será desinstalada.

PS> Uninstall-Package -Name NuGet.Core

Exemplo 2: utilizar o pipeline para desinstalar um pacote

Get-Package localiza um pacote específico e envia o objeto SoftwareIdentity pelo pipeline para o Uninstall-Package cmdlet .

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

O Get-Package cmdlet utiliza os parâmetros Name e RequiredVersion para especificar um pacote. Um objeto SoftwareIdentity é enviado pelo pipeline. O Uninstall-Package cmdlet recebe o objeto como um InputObject e remove o pacote.

Como alternativa, o Uninstall-Package cmdlet pode especificar um valor para o parâmetro InputObject :

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

Parâmetros

-AllowClobber

Substitui mensagens de aviso sobre conflitos com comandos existentes. Substitui comandos existentes que têm o mesmo nome que os comandos que estão a ser instalados.

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

-AllowPrereleaseVersions

Permite que os pacotes marcados como pré-lançamento sejam desinstalados.

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

-AllVersions

Indica que este cmdlet desinstala todas as versões do pacote.

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

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

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

-Destination

Especifica uma cadeia do caminho para o objeto de entrada.

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

-ExcludeVersion

Mude para excluir o número da versão no caminho da pasta.

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

-Force

Força o comando a ser executado sem pedir a confirmação do utilizador.

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

-ForceBootstrap

Força o PackageManagement a instalar automaticamente o fornecedor de pacotes para o pacote especificado.

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

-InputObject

Aceita a entrada do pipeline que especifica o objeto SoftwareIdentity do pacote a Get-Package partir do cmdlet . InputObject aceita o objeto SoftwareIdentity como um Get-Package valor ou uma variável que contém o 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 as atualizações.

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

-MaximumVersion

Especifica a versão máxima permitida do pacote que pretende desinstalar. Se não especificar este parâmetro, Uninstall-Package desinstala a versão mais recente do pacote.

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

-MinimumVersion

Especifica a versão mínima permitida do pacote que pretende desinstalar. Se não adicionar este parâmetro, Uninstall-Package desinstala a versão mais recente do pacote que satisfaça qualquer versão especificada pelo parâmetro MaximumVersion .

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

-Name

Especifica um ou mais nomes de pacotes. Vários nomes de pacotes têm de ser separados por vírgulas.

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

-NoPathUpdate

NoPathUpdate aplica-se apenas ao Install-Script cmdlet . NoPathUpdate é um parâmetro dinâmico adicionado pelo fornecedor e não é suportado pelo Uninstall-Package.

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

-PackageManagementProvider

Especifica o fornecedor PackageManagement .

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

-ProviderName

Especifica um ou mais nomes de fornecedores de pacotes para procurar pacotes. Pode obter nomes de fornecedores de pacotes ao executar o Get-PackageProvider cmdlet .

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 a versão exata permitida do pacote que pretende desinstalar. Se não adicionar este parâmetro, Uninstall-Package desinstala a versão mais recente do pacote que satisfaça qualquer versão especificada pelo parâmetro MaximumVersion .

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

-Scope

Especifica o âmbito para o qual desinstalar o pacote. Os valores aceitáveis para este parâmetro são os seguintes:

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

-SkipDependencies

Ignora a desinstalação de dependências de software.

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

-SkipPublisherCheck

Permite-lhe obter uma versão de pacote mais recente do que a versão instalada. Por exemplo, um pacote instalado assinado digitalmente por um fabricante fidedigno, mas que não tem uma nova versão assinada digitalmente.

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

-Type

Especifica se pretende procurar pacotes com um módulo, um script ou ambos. Os valores aceitáveis para este parâmetro são os seguintes:

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

-WhatIf

Mostra o que aconteceria se Uninstall-Package o cmdlet fosse executado. O cmdlet não é executado.

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

Entradas

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Pode encaminhar objetos SoftwareIdentity para este cmdlet.

Saídas

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Este cmdlet devolve um objeto SoftwareIdentity para cada pacote desinstalado.

Notas

A inclusão de um fornecedor de pacotes num comando pode disponibilizar parâmetros dinâmicos a um cmdlet. Os parâmetros dinâmicos são específicos de um fornecedor de pacotes. O Get-Help cmdlet lista os conjuntos de parâmetros de um cmdlet e inclui o conjunto de parâmetros do fornecedor. Por exemplo, Uninstall-Package tem o conjunto de parâmetros PowerShellGet que inclui -NoPathUpdate, AllowClobbere SkipPublisherCheck.