Compartilhar via


Uninstall-Module

Desinstala um módulo.

Syntax

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. Não será possível 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 para Uninstall-Module e é desinstalado.

Parâmetros

-AllowPrerelease

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

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

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

-AllVersions

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

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

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

-Confirm

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

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

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

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

-MaximumVersion

O cmdlet 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.

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

-MinimumVersion

O cmdlet 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.

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

-Name

Especifica uma matriz de nomes de módulo a serem desinstalados.

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

-RequiredVersion

O cmdlet 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.

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

-WhatIf

Mostra o que aconteceria se Uninstall-Module 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

String[]

PSObject[]

String

Saídas

Object