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, use o Get-Package cmdlet .

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. Os 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 Uninstall-Package cmdlet 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 pelo pipeline para o Uninstall-Package cmdlet .

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

O Get-Package cmdlet usa 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 os comandos existentes que têm o mesmo nome que os comandos que estão sendo instalados.

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

-AllowPrereleaseVersions

Permite que 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 esse 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 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 de caracteres 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

Alterne para excluir o número de 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 solicitar a confirmação do usuário.

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 provedor 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 de pipeline que especifica o objeto SoftwareIdentity do pacote do Get-Package 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 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 você deseja desinstalar. Se você não especificar esse parâmetro, Uninstall-Package desinstalará 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 você deseja desinstalar. Se você não adicionar esse parâmetro, Uninstall-Package desinstalará 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 pacote. Vários nomes de pacote devem ser separados por vírgulas.

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

-NoPathUpdate

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

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

-PackageManagementProvider

Especifica o provedor 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 provedor de pacotes para pesquisar pacotes. Você pode obter os nomes de provedor de pacotes executando o 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 a versão exata permitida do pacote que você deseja desinstalar. Se você não adicionar esse parâmetro, Uninstall-Package desinstalará 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 escopo para o qual desinstalar o pacote. Os valores aceitáveis para esse 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 que você obtenha uma versão do pacote 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.

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

-Type

Especifica se os pacotes devem ser pesquisados com um módulo, um script ou ambos. Os valores aceitáveis para esse 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

Você pode canalizar objetos SoftwareIdentity para este cmdlet.

Saídas

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Esse cmdlet retorna um objeto SoftwareIdentity para cada pacote desinstalado.

Observações

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 para um provedor de pacotes. O Get-Help cmdlet 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 do PowerShellGet que inclui -NoPathUpdate, AllowClobbere SkipPublisherCheck.