Partilhar via

Uninstall-Package

Módulo:
PackageManagement Module

Desinstala um ou mais pacotes de software.

Sintaxe

PackageByInputObject 

Uninstall-Package
    [-InputObject] <SoftwareIdentity[]>
    [-AllVersions]
    [-Force]
    [-ForceBootstrap]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

PackageBySearch 

Uninstall-Package
    [-Name] <String[]>
    [-RequiredVersion <String>]
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-AllVersions]
    [-Force]
    [-ForceBootstrap]
    [-WhatIf]
    [-Confirm]
    [-ProviderName <String[]>]
    [<CommonParameters>]

NuGet:PackageByInputObject 

Uninstall-Package
    [-AllVersions]
    [-Force]
    [-ForceBootstrap]
    [-WhatIf]
    [-Confirm]
    [-Destination <String>]
    [-ExcludeVersion]
    [-Scope <String>]
    [-SkipDependencies]
    [<CommonParameters>]

NuGet:PackageBySearch 

Uninstall-Package
    [-AllVersions]
    [-Force]
    [-ForceBootstrap]
    [-WhatIf]
    [-Confirm]
    [-Destination <String>]
    [-ExcludeVersion]
    [-Scope <String>]
    [-SkipDependencies]
    [<CommonParameters>]

PowerShellGet:PackageByInputObject 

Uninstall-Package
    [-AllVersions]
    [-Force]
    [-ForceBootstrap]
    [-WhatIf]
    [-Confirm]
    [-Scope <String>]
    [-PackageManagementProvider <String>]
    [-Type <String>]
    [-AllowClobber]
    [-SkipPublisherCheck]
    [-InstallUpdate]
    [-NoPathUpdate]
    [-AllowPrereleaseVersions]
    [<CommonParameters>]

PowerShellGet:PackageBySearch 

Uninstall-Package
    [-AllVersions]
    [-Force]
    [-ForceBootstrap]
    [-WhatIf]
    [-Confirm]
    [-Scope <String>]
    [-PackageManagementProvider <String>]
    [-Type <String>]
    [-AllowClobber]
    [-SkipPublisherCheck]
    [-InstallUpdate]
    [-NoPathUpdate]
    [-AllowPrereleaseVersions]
    [<CommonParameters>]

Description

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

Importante

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

Exemplos

Exemplo 1: Desinstalar um pacote

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

PS> Uninstall-Package -Name NuGet.Core

Exemplo 2: Usar o pipeline para desinstalar um pacote

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

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

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

Como alternativa, o 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 dos comandos que estão sendo instalados.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

PowerShellGet:PackageByInputObject
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
PowerShellGet:PackageBySearch
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-AllowPrereleaseVersions

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

PowerShellGet:PackageByInputObject
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
PowerShellGet:PackageBySearch
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-AllVersions

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Cf.

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Destination

Especifica uma cadeia de caracteres do caminho para o objeto de entrada.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

NuGet:PackageByInputObject
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
NuGet:PackageBySearch
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ExcludeVersion

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

NuGet:PackageByInputObject
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
NuGet:PackageBySearch
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Force

Força o comando a ser executado sem pedir a confirmação do usuário.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ForceBootstrap

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-InputObject

Aceita entrada de pipeline que especifica o objeto SoftwareIdentity do pacote do cmdlet . InputObject aceita o objeto SoftwareIdentity como um valor Get-Package ou uma variável que contém o objeto.

Propriedades dos parâmetros

Tipo:

Microsoft.PackageManagement.Packaging.SoftwareIdentity[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

PackageByInputObject
Position:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-InstallUpdate

Indica que Uninstall-Package desinstala atualizações.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

PowerShellGet:PackageByInputObject
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
PowerShellGet:PackageBySearch
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-MaximumVersion

Especifica a versão máxima permitida do pacote que você deseja desinstalar. Se você não especificar esse parâmetro, Uninstall-Package desinstalará a versão mais recente do pacote.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

PackageBySearch
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-MinimumVersion

Especifica a versão mínima permitida do pacote que você deseja desinstalar. Se você não adicionar esse parâmetro, desinstalará a versão mais recente do pacote que satisfaça qualquer versão especificada pelo parâmetro MaximumVersion.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

PackageBySearch
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Name

Especifica um ou mais nomes de pacote. Vários nomes de pacotes devem ser separados por vírgulas.

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

PackageBySearch
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-NoPathUpdate

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

PowerShellGet:PackageByInputObject
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
PowerShellGet:PackageBySearch
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-PackageManagementProvider

Especifica o provedor de PackageManagement.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

PowerShellGet:PackageByInputObject
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
PowerShellGet:PackageBySearch
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ProviderName

Especifica um ou mais nomes de provedores de pacotes para pesquisar pacotes. Você pode obter nomes de provedores de pacotes executando o cmdlet Get-PackageProvider.

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Valores aceites:Bootstrap, NuGet, PowerShellGet
Suporta carateres universais:False
NãoMostrar:False
Aliases:Fornecedor

Conjuntos de parâmetros

PackageBySearch
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-RequiredVersion

Especifica a versão permitida exata do pacote que você deseja desinstalar. Se você não adicionar esse parâmetro, desinstalará a versão mais recente do pacote que satisfaça qualquer versão especificada pelo parâmetro MaximumVersion.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

PackageBySearch
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Scope

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

  • Utilizador Atual
  • Todos os Utilizadores

Propriedades dos parâmetros

Tipo:String
Default value:None
Valores aceites:CurrentUser, AllUsers
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

NuGet:PackageByInputObject
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
NuGet:PackageBySearch
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
PowerShellGet:PackageByInputObject
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
PowerShellGet:PackageBySearch
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-SkipDependencies

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

NuGet:PackageByInputObject
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
NuGet:PackageBySearch
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-SkipPublisherCheck

Permite que você obtenha uma versão do pacote que é mais recente do que a versão instalada. Por exemplo, um pacote instalado que é assinado digitalmente por um editor confiável, mas uma nova versão não é assinada digitalmente.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

PowerShellGet:PackageByInputObject
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
PowerShellGet:PackageBySearch
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Type

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

  • Módulo
  • Script
  • Todos

Propriedades dos parâmetros

Tipo:String
Default value:None
Valores aceites:Module, Script, All
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

PowerShellGet:PackageByInputObject
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
PowerShellGet:PackageBySearch
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-WhatIf

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Wi

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Você pode canalizar objetos SoftwareIdentity para este cmdlet.

Saídas

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Este cmdlet retorna um objeto SoftwareIdentity para cada pacote desinstalado.

Notas

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