Compartilhar via


Uninstall-Module

Desinstala um módulo.

Sintaxe

Uninstall-Module
         [-Name] <String[]>
         [-MinimumVersion <String>]
         [-RequiredVersion <String>]
         [-MaximumVersion <String>]
         [-AllVersions]
         [-Force]
         [-AllowPrerelease]
         [-WhatIf]
         [-Confirm]
         [<CommonParameters>]
Uninstall-Module
         [-InputObject] <PSObject[]>
         [-Force]
         [-WhatIf]
         [-Confirm]
         [<CommonParameters>]

Description

O Uninstall-Module cmdlet desinstala um módulo especificado do computador local. Você não poderá desinstalar um módulo se outros módulos dependerem dele ou se o módulo não tiver sido instalado com o Install-Module cmdlet.

Este é um cmdlet proxy para o Uninstall-PSResource cmdlet no Microsoft.PowerShell.PSResourceGet. Para obter mais informações, consulte Uninstall-PSResource.

Exemplos

Exemplo 1: Desinstalar um módulo

Este exemplo desinstala um módulo.

Uninstall-Module -Name SpeculationControl

Uninstall-Module usa o parâmetro Name para especificar o módulo a ser desinstalado do computador local.

Exemplo 2: Usar o pipeline para desinstalar um módulo

Neste exemplo, o pipeline é usado para desinstalar um módulo.

Get-InstalledModule -Name SpeculationControl | Uninstall-Module

Get-InstalledModule usa o parâmetro Name para especificar o módulo. O objeto é enviado pelo pipeline e Uninstall-Module desinstalado.

Parâmetros

-AllowPrerelease

Permite desinstalar um módulo marcado como pré-lançamento.

O cmdlet de proxy mapeia esse parâmetro para o parâmetro Prerelease de Uninstall-PSResource

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AllVersions

Especifica que você deseja incluir todas as versões disponíveis de um módulo. Você não pode usar o parâmetro AllVersions com os parâmetrosMinimumVersion, MaximumVersion ou RequiredVersion .

O cmdlet de proxy transforma esse parâmetro antes -Version * de chamar Uninstall-PSResource.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita a confirmação antes de executar o Uninstall-Module.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Force

O cmdlet de proxy ignora esse parâmetro, pois ele não tem suporte Uninstall-PSResource.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Aceita um objeto PSRepositoryItemInfo . Por exemplo, saída Get-InstalledModule para uma variável e use essa variável como o argumento InputObject .

Tipo:PSObject[]
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-MaximumVersion

O cmdlet de proxy usa o valor desse parâmetro para criar uma cadeia de caracteres de pesquisa de versão do NuGet para uso com o parâmetro Version de Uninstall-PSResource.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-MinimumVersion

O cmdlet de proxy usa o valor desse parâmetro para criar uma cadeia de caracteres de pesquisa de versão do NuGet para uso com o parâmetro Version de Uninstall-PSResource.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

Especifica uma matriz de nomes de módulo para desinstalar.

Tipo:String[]
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-RequiredVersion

O cmdlet de proxy usa o valor desse parâmetro para criar uma cadeia de caracteres de pesquisa de versão do NuGet para uso com o parâmetro Version de Uninstall-PSResource.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

String[]

PSObject[]

String

Saídas

Object