Quita módulos de la sesión actual.

Sintaxis

Remove-Module [-ModuleInfo] <PSModuleInfo[]> [-Force] [-Confirm] [-WhatIf] [<CommonParameters>]

Remove-Module [-Name] <string[]> [-Force] [-Confirm] [-WhatIf] [<CommonParameters>]

Descripción

El cmdlet Remove-Module quita los miembros de un módulo de la sesión actual.

Si el módulo incluye un ensamblado (.dll), se quitan todos los miembros implementados por el ensamblado, pero el ensamblado no se descarga.

Parámetros

-Force

Quita módulos aunque su modo de acceso sea de solo lectura.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-ModuleInfo <PSModuleInfo[]>

Especifica los objetos de módulo que se han de quitar. Escriba una variable que contenga un objeto de módulo (PSModuleInfo) o un comando que lo obtenga, como un comando Get-Module. También se pueden canalizar objetos de módulo a Remove-Module.

¿Requerido?

true

¿Posición?

1

Valor predeterminado

¿Aceptar canalización?

true (ByValue)

¿Aceptar caracteres comodín?

false

-Name <string[]>

Especifica los nombres de los módulos que se han de quitar. Se permite el uso de caracteres comodín. También se pueden canalizar cadenas de nombre a Remove-Module.

¿Requerido?

true

¿Posición?

1

Valor predeterminado

¿Aceptar canalización?

true (ByValue)

¿Aceptar caracteres comodín?

true

-Confirm

Solicita confirmación antes de ejecutar el comando.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-WhatIf

Describe lo que ocurriría si se ejecutara el comando, sin ejecutarlo realmente.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.

Entradas y salidas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.

Entradas

System.String, System.Management.Automation.PSModuleInfo

Se pueden canalizar nombres de módulo (cadenas) y objetos de módulo a Remove-Module.

Salidas

Ninguno

Remove-Module no genera resultados.

Notas

También se puede hacer referencia a Remove-Module por su alias, "rmo". Para obtener más información, vea about_Aliases.

Ejemplo 1

C:\PS>remove-module -name BitsTransfer

Descripción
-----------
Este comando quita el módulo BitsTransfer de la sesión actual.






Ejemplo 2

C:\PS>get-module | remove-module

Descripción
-----------
Este comando quita todos los módulos de la sesión actual.






Ejemplo 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')".

Descripción
-----------
Este comando quita los módulos FileTransfer y PSDiagnostics de la sesión actual.

El comando utiliza un operador de canalización (|) para enviar los nombres de módulo a Remove-Module. Utiliza el parámetro común Verbose para obtener información detallada sobre los miembros que se quitan.

Los mensajes Verbose muestran los elementos que se quitan. Los mensajes difieren porque el módulo BitsTransfer incluye un ensamblado que implementa sus cmdlets y un módulo anidado con su propio ensamblado. El módulo PSDiagnostics incluye un archivo de script de módulo (.psm1) que exporta funciones.






Ejemplo 4

C:\PS>$a = get-module BitsTransfer

C:\PS> remove-module -moduleInfo $a

Descripción
-----------
Este comando utiliza el parámetro ModuleInfo para quitar el módulo BitsTransfer.






Vea también




Tabla de contenido