Rimuove i moduli dalla sessione corrente.

Sintassi

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

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

Descrizione

Il cmdlet Remove-Module rimuove i membri di un modulo dalla sessione corrente.

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

Parametri

-Force

Rimuove i moduli anche quando la modalità di accesso è in sola lettura.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-ModuleInfo <PSModuleInfo[]>

Specifica gli oggetti del modulo da rimuovere. Immettere una variabile che contiene un oggetto modulo (PSModuleInfo) o un comando che ottiene un oggetto modulo, ad esempio un comando Get-Module. È inoltre possibile reindirizzare oggetti modulo a Remove-Module.

Obbligatorio?

true

Posizione?

1

Valore predefinito

Accettare input da pipeline?

true (ByValue)

Accettare caratteri jolly?

false

-Name <string[]>

Specifica i nomi dei moduli da rimuovere. È consentito l'utilizzo di caratteri jolly. È anche possibile reindirizzare stringhe di nomi a Remove-Module.

Obbligatorio?

true

Posizione?

1

Valore predefinito

Accettare input da pipeline?

true (ByValue)

Accettare caratteri jolly?

true

-Confirm

Chiede una conferma prima di eseguire il comando.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-WhatIf

Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

<CommonParameters>

Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.

Input e output

Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.

Input

System.String, System.Management.Automation.PSModuleInfo

È anche possibile reindirizzare nomi di moduli (stringhe) e oggetti modulo a Remove-Module.

Output

Nessuno

Remove-Module non genera alcun output.

Note

È anche possibile fare riferimento a Remove-Module tramite il relativo alias, "rmo". Per ulteriori informazioni, vedere about_Aliases.

Esempio 1

C:\PS>remove-module -name BitsTransfer

Descrizione
-----------
Questo comando rimuove il modulo BitsTransfer dalla sessione corrente.






Esempio 2

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

Descrizione
-----------
Questo comando rimuove tutti i moduli dalla sessione corrente.






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

Descrizione
-----------
Questo comando rimuove i moduli FileTransfer e PSDiagnostics dalla sessione corrente.

Nel comando viene utilizzato un operatore pipeline (|) per inviare i nomi dei moduli a Remove-Module. Viene utilizzato il parametro comune Verbose per ottenere informazioni dettagliate sui membri rimossi.

Nei messaggi Verbose vengono indicati gli elementi rimossi. I messaggi differiscono perché il modulo BitsTransfer include un assembly che implementa i cmdlet e un modulo nidificato con il relativo assembly. Il modulo PSDiagnostics include un file script del modulo (.psm1) che esporta funzioni.






Esempio 4

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

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

Descrizione
-----------
Questo comando utilizza il parametro ModuleInfo per rimuovere il modulo BitsTransfer.






Vedere anche




Argomenti della Guida