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 pode 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 .
Pode eliminar manualmente os ficheiros do módulo, mas fazê-lo pode interromper quaisquer módulos que dependam do módulo eliminado.
Os parâmetros que assumem os números da versão do módulo esperam cadeias formatadas como números de versão.
- Os números de versão padrão têm um formato de
x.y.zonde 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 é 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 utiliza o parâmetro Nome para especificar o módulo a desinstalar do computador local.
Exemplo 2: utilizar o pipeline para desinstalar um módulo
Neste exemplo, o pipeline é utilizado para desinstalar um módulo.
Get-InstalledModule -Name SpeculationControl | Uninstall-ModuleGet-InstalledModule utiliza o parâmetro Nome para especificar o módulo. O objeto é enviado pelo pipeline para Uninstall-Module e é desinstalado.
Parâmetros
-AllowPrerelease
Permite-lhe 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 pretende incluir todas as versões disponíveis de um módulo. Não pode utilizar o parâmetro AllVersions com os parâmetros MinimumVersion, MaximumVersion ou RequiredVersion .
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Pede-lhe 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 executar sem pedir a confirmação do utilizador.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Aceita um objeto PSRepositoryItemInfo . Por exemplo, produza Get-InstalledModule para uma variável e utilize essa variável como 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 desinstalar. Os parâmetros MaximumVersion e RequiredVersion não podem ser utilizados 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 desinstalar. Os parâmetros MinimumVersion e RequiredVersion não podem ser utilizados 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ódulos a desinstalar.
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-RequiredVersion
Especifica o número exato da versão do módulo a desinstalar.
| 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[]
