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. Você não poderá desinstalar um módulo se outros módulos dependerem dele ou se o módulo não estiver instalado com o Install-Module cmdlet .
Você pode excluir manualmente os arquivos de módulo, mas isso pode interromper todos os módulos que dependem do módulo excluído.
Os parâmetros que levam números de versão do módulo esperam cadeias de caracteres formatadas como números de versão.
- Os números de versão padrão têm um formato em
x.y.zque x, y e z são números - As versões de pré-lançamento têm um formato de
x.y.z-<prerelease_label>onde a<prerelease_label>cadeia de caracteres é arbitrária atribuída a essa versão.
Exemplos
Exemplo 1: Desinstalar um módulo
Este exemplo desinstala um módulo.
Uninstall-Module -Name SpeculationControlUninstall-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-ModuleGet-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.
| 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. Você não pode usar o parâmetro AllVersions com os parâmetrosMinimumVersion, MaximumVersion ou RequiredVersion .
| 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
Força Uninstall-Module a execução 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 |
-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
Especifica a versão máxima ou mais recente do módulo a ser desinstalada. Os parâmetros MaximumVersion e RequiredVersion não podem ser usados no mesmo comando.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-MinimumVersion
Especifica a versão mínima do módulo a ser desinstalada. Os parâmetros MinimumVersion e RequiredVersion não podem ser usados no mesmo comando.
| 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 para desinstalar.
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-RequiredVersion
Especifica o número de versão exato do módulo a ser desinstalado.
| 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[]
