Remove-Module
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 |
Nenhum 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.