Remove módulos da sessão atual.
Sintaxe
Remove-Module [-ModuleInfo] <PSModuleInfo[]> [-Force] [-Confirm] [-WhatIf] [<CommonParameters>] Remove-Module [-Name] <string[]> [-Force] [-Confirm] [-WhatIf] [<CommonParameters>]
Descrição
O cmdlet Remove-Module remove os membros de um módulo da sessão atual.
Se o módulo incluir um assembly (.dll), serão removidos todos os membros implementados pelo assembly, mas o assembly não será descarregado.
Parâmetros
-Force
Remove módulos até mesmo quando seu modo de acesso é somente leitura.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
-ModuleInfo <PSModuleInfo[]>
Especifica os objetos do módulo a serem removidos. Insira uma variável que contenha um objeto de módulo (PSModuleInfo) ou um comando que obtenha um objeto de módulo, como um comando Get-Module. Você também pode canalizar objetos de módulo para Remove-Module.
|
Necessário? |
true |
|
Posição? |
1 |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
true (ByValue) |
|
Aceitar caracteres curinga? |
false |
-Name <string[]>
Especifica os nomes dos módulos a serem removidos. Os caracteres curinga são permitidos. Também é possível canalizar cadeias de caracteres de nome para Remove-Module.
|
Necessário? |
true |
|
Posição? |
1 |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
true (ByValue) |
|
Aceitar caracteres curinga? |
true |
-Confirm
Solicita confirmação antes da execução do comando.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
-WhatIf
Descreve o que aconteceria se você executasse o comando, sem executá-lo de fato.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
<CommonParameters>
Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.
Entradas e saídas
O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.
|
Entradas |
System.String, System.Management.Automation.PSModuleInfo Você pode canalizar nomes de módulo (cadeias de caracteres) e objetos de módulo para Remove-Module. |
|
Saídas |
None Remove-Module não gera saída. |
Observações
Também é possível referenciar Remove-Module usando seu alias, "rmo". Para obter mais informações, consulte about_Aliases.
Exemplo 1
C:\PS>remove-module -name BitsTransfer Descrição ----------- Esse comando remove o módulo BitsTransfer da sessão atual.
Exemplo 2
C:\PS>get-module | remove-module Descrição ----------- Esse comando remove todos os módulo da sessão atual.
Exemplo 3
C:\PS>"FileTransfer", "PSDiagnostics" | remove-module -verbose VERBOSE: Performing operation "Remove-Module" on Target "filetransfer (Path: 'C:\Windows\system32\WindowsPowerShell\v1.0\Modules\f iletransfer\filetransfer.psd1')". VERBOSE: Performing operation "Remove-Module" on Target "Microsoft.BackgroundIntelligentTransfer.Management (Path: 'C:\Windows\ assembly\GAC_MSIL\Microsoft.BackgroundIntelligentTransfer.Management\1.0.0.0__31bf3856ad364e35\Microsoft.BackgroundIntelligentTransfe r.Management.dll')". VERBOSE: Performing operation "Remove-Module" on Target "psdiagnostics (Path: 'C:\Windows\system32\WindowsPowerShell\v1.0\Modules\ psdiagnostics\psdiagnostics.psd1')". VERBOSE: Removing imported function 'Start-Trace'. VERBOSE: Removing imported function 'Stop-Trace'. VERBOSE: Removing imported function 'Enable-WSManTrace'. VERBOSE: Removing imported function 'Disable-WSManTrace'. VERBOSE: Removing imported function 'Enable-PSWSManCombinedTrace'. VERBOSE: Removing imported function 'Disable-PSWSManCombinedTrace'. VERBOSE: Removing imported function 'Set-LogProperties'. VERBOSE: Removing imported function 'Get-LogProperties'. VERBOSE: Removing imported function 'Enable-PSTrace'. VERBOSE: Removing imported function 'Disable-PSTrace'. VERBOSE: Performing operation "Remove-Module" on Target "PSDiagnostics (Path: 'C:\Windows\system32\WindowsPowerShell\v1.0\Modules\ psdiagnostics\PSDiagnostics.psm1')". Descrição ----------- Esse comando remove o módulo FileTransfer e os módulos PSDiagnostics da sessão atual. O comando usa um operador de pipeline (|) para enviar os nomes de módulos para Remove-Module. Ele usa o parâmetro comum Verbose para obter informações detalhadas sobre os membros que são removidos. As mensagens Detalhadas mostram os itens que são removidos. As mensagens diferem porque o módulo BitsTransfer inclui um assembly que implementa seus cmdlets e um módulo aninhado com seu próprio assembly. O módulo PSDiagnostics inclui um arquivo de script de módulo (.psm1) que exporta funções.
Exemplo 4
C:\PS>$a = get-module BitsTransfer C:\PS> remove-module -moduleInfo $a Descrição ----------- Esse comando usa o parâmetro ModuleInfo para remover o módulo BitsTransfer.
See Also