Condividi tramite

Remove-Module

  • Riferimento
Modulo:
Microsoft.PowerShell.Core

Rimuove moduli dalla sessione corrente.

Sintassi

Remove-Module
      [-Name] <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-Module
      [-FullyQualifiedName] <ModuleSpecification[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-Module
      [-ModuleInfo] <PSModuleInfo[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descrizione

Il cmdlet Remove-Module rimuove i membri di un modulo, ad esempio cmdlet e funzioni, dalla sessione corrente.

Se il modulo include un assembly (.dll), tutti i membri implementati dall'assembly vengono rimossi, ma l'assembly non viene scaricato.

Questo cmdlet non disinstalla il modulo né lo elimina dal computer. Influisce solo sulla sessione corrente di PowerShell.

Esempio

Esempio 1: Rimuovere un modulo

Remove-Module -Name "BitsTransfer"

Questo comando rimuove il modulo BitsTransfer dalla sessione corrente.

Esempio 2: Rimuovere tutti i moduli

Get-Module | Remove-Module

Questo comando rimuove tutti i moduli dalla sessione corrente.

Esempio 3: Rimuovere moduli usando la pipeline

"FileTransfer", "PSDiagnostics" | Remove-Module -Verbose

VERBOSE: Performing operation "Remove-Module" on Target "filetransfer (Path: 'C:\Windows\system32\WindowsPowerShell\v1.0\Modules\filetransfer\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')".

Questo comando rimuove i moduli BitsTransfer e PSDiagnostics dalla sessione corrente.

Il comando usa un operatore pipeline (|) per inviare i nomi dei moduli a Remove-Module. Usa il parametro comune Verbose per ottenere informazioni dettagliate sui membri che vengono rimossi.

I messaggi dettagliati mostrano gli elementi rimossi. I messaggi sono diversi perché il modulo BitsTransfer include un assembly che implementa i relativi cmdlet e un modulo annidato con il proprio assembly. Il modulo PSDiagnostics include un file di script del modulo (.psm1) che esporta le funzioni.

Esempio 4: Rimuovere un modulo usando ModuleInfo

$a = Get-Module BitsTransfer
Remove-Module -ModuleInfo $a

Questo comando usa il parametro ModuleInfo per rimuovere il modulo BitsTransfer.

Parametri

-Confirm

Richiede la conferma dell'utente prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Indica che questo cmdlet rimuove i moduli di sola lettura. Per impostazione predefinita, Remove-Module rimuove solo i moduli di lettura-scrittura.

I valori ReadOnly e ReadWrite vengono archiviati nella proprietà AccessMode di un modulo.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FullyQualifiedName

Specifica i nomi completi dei moduli da rimuovere.

Type:ModuleSpecification[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ModuleInfo

Specifica gli oggetti modulo da rimuovere. Immettere una variabile contenente un oggetto modulo (PSModuleInfo) o un comando che ottiene un oggetto modulo, ad esempio un comando Get-Module. È anche possibile inviare tramite pipe gli oggetti modulo a Remove-Module.

Type:PSModuleInfo[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Specifica i nomi dei moduli da rimuovere. I caratteri jolly sono consentiti. È anche possibile inviare tramite pipe le stringhe dei nomi a Remove-Module.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

System.String, System.Management.Automation.PSModuleInfo

È possibile inviare tramite pipe i nomi dei moduli e gli oggetti modulo a Remove-Module.

Output

None

Questo cmdlet non genera alcun output.