Uninstall-Module
Desinstala um módulo.
Sintaxe
NameParameterSet (Predefinição)
Uninstall-Module
[-Name] <String[]>
[-MinimumVersion <Version>]
[-RequiredVersion <Version>]
[-MaximumVersion <Version>]
[-Force]
[-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 ele tiver outros módulos como dependências.
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
-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: | Version |
| 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: | Version |
| 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: | Version |
| 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.
Entradas
PSRepositoryItemInfo
Uninstall-Module aceita objetos PSRepositoryItemInfo do pipeline.