Compartilhar via


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.





Consulte também

Conceitos

Get-Module
Import-Module
about_Modules