Remove-Module
Supprime des modules de la session active.
Syntaxe
Remove-Module [-ModuleInfo] <PSModuleInfo[]> [-Force] [-Confirmer] [-WhatIf] [<CommonParameters>]
Remove-Module [-Name] <string[]> [-Force] [-Confirmer] [-WhatIf] [<CommonParameters>]
Description
L'applet de commande Remove-Module supprime les membres d'un module de la session active.
Si le module inclut un assembly (.dll), tous les membres implémentés par l'assembly sont supprimés, mais l'assembly n'est pas déchargé.
Paramètres
-Force
Supprime des modules même lorsque leur mode d'accès est en lecture seule.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-ModuleInfo <PSModuleInfo[]>
Spécifie les objets de module à supprimer. Entrez une variable qui contient un objet de module (PSModuleInfo) ou une commande qui obtient un objet de module, telle que la commande Get-Module. Vous pouvez également diriger des objets de module vers Remove-Module.
Obligatoire ? |
true |
Position ? |
1 |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
true (ByValue) |
Accepter les caractères génériques ? |
false |
-Name <string[]>
Spécifie les noms des modules à supprimer. Les caractères génériques sont autorisés. Vous pouvez également diriger des chaînes de noms vers Remove-Module.
Obligatoire ? |
true |
Position ? |
1 |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
true (ByValue) |
Accepter les caractères génériques ? |
true |
-Confirmer
Vous invite à confirmer l'exécution de la commande.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-WhatIf
Décrit le résultat que vous obtiendriez en exécutant la commande, sans réellement l'exécuter.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.
Entrées et sorties
Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.
Entrées |
System.String, System.Management.Automation.PSModuleInfo Vous pouvez diriger des noms de modules (chaînes) et des objets de module vers Remove-Module. |
Sorties |
Aucun Remove-Module ne génère aucune sortie. |
Remarques
Vous pouvez également faire référence à Remove-Module par son alias, « rmo ». Pour plus d'informations, consultez about_Aliases.
Exemple 1
C:\PS>remove-module -name BitsTransfer
Description
-----------
Cette commande supprime le module BitsTransfer de la session active.
Exemple 2
C:\PS>get-module | remove-module
Description
-----------
Cette commande supprime tous les modules de la session active.
Exemple 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')".
Description
-----------
Cette commande supprime les modules FileTransfer et PSDiagnostics de la session active.
Elle utilise un opérateur de pipeline (|) pour envoyer les noms de modules à Remove-Module. Elle fait appel au paramètre courant Verbose pour obtenir des informations détaillées sur les membres supprimés.
Les messages de commentaires précisent les éléments supprimés. Les messages diffèrent car le module BitsTransfer inclut un assembly qui implémente ses applets de commande et un module imbriqué doté de son propre assembly. Le module PSDiagnostics inclut un fichier de script de module (.psm1) qui exporte des fonctions.
Exemple 4
C:\PS>$a = get-module BitsTransfer
C:\PS> remove-module -moduleInfo $a
Description
-----------
Cette commande utilise le paramètre ModuleInfo pour supprimer le module BitsTransfer.