Uninstall-Module
Desinstala um módulo.
Sintaxe
NameParameterSet (Predefinição)
Uninstall-Module
[-Name] <String[]>
[-MinimumVersion <String>]
[-RequiredVersion <String>]
[-MaximumVersion <String>]
[-AllVersions]
[-Force]
[-AllowPrerelease]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InputObject
Uninstall-Module
[-InputObject] <PSObject[]>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet Uninstall-Module desinstala um módulo especificado do computador local. Não é 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.
Você pode excluir manualmente os arquivos do módulo, mas isso pode quebrar quaisquer módulos que dependem do módulo excluído.
Os parâmetros que usam 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 em que a
x.y.z-<prerelease_label>cadeia de<prerelease_label>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 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.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
NameParameterSet
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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âmetros MinimumVersion, MaximumVersionou RequiredVersion.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
NameParameterSet
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Confirm
Solicita confirmação antes de executar o Uninstall-Module.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Cf. |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Force
Força Uninstall-Module a executar sem pedir a confirmação do usuário.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-InputObject
Aceita um objeto PSRepositoryItemInfo. Por exemplo, a saída
Propriedades dos parâmetros
| Tipo: | PSObject[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
InputObject
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-MaximumVersion
Especifica a versão máxima, ou mais recente, do módulo a ser desinstalado. Os parâmetros MaximumVersion e RequiredVersion não podem ser usados no mesmo comando.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
NameParameterSet
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-MinimumVersion
Especifica a versão mínima do módulo a ser desinstalado. Os parâmetros MinimumVersion e RequiredVersion não podem ser usados no mesmo comando.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
NameParameterSet
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-Name
Especifica uma matriz de nomes de módulo a serem desinstalados.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
NameParameterSet
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-RequiredVersion
Especifica o número exato da versão do módulo a ser desinstalado.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
NameParameterSet
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-WhatIf
Mostra o que aconteceria se Uninstall-Module corresse. O cmdlet não é executado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Wi |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
