共用方式為

Remove-Module

  • 參考
模組:
Microsoft.PowerShell.Core

從目前的工作階段中移除模組。

語法

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

Description

Remove-Module Cmdlet 會從目前的會話中移除模組的成員，例如 Cmdlet 和函式。

如果模組包含元件 （.dll），則會移除元件實作的所有成員，但不會卸除元件。

此 Cmdlet 不會卸載模組，也不會從計算機中刪除它。 它只會影響目前的PowerShell會話。

範例

範例 1：移除模組

Remove-Module -Name "BitsTransfer"

此命令會從目前的會話中移除 BitsTransfer 模組。

範例 2：移除所有模組

Get-Module | Remove-Module

此命令會從目前的工作階段中移除所有模組。

範例 3：使用管線移除模組

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

此命令會從目前的會話中移除 BitsTransfer 和 PSDiagnostics 模組。

命令會使用管線運算符 （|） 將模組名稱傳送至 remove-Module。 它會使用 Verbose 一般參數來取得已移除成員的詳細資訊。

詳細資訊 訊息會顯示已移除的專案。 訊息不同，因為 BitsTransfer 模組包含實作其 Cmdlet 的元件，以及具有其本身元件的巢狀模組。 PSDiagnostics 模組包含導出函式的模組腳本檔案 （.psm1）。

範例 4：使用 ModuleInfo 移除模組

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

此命令會使用 ModuleInfo 參數來移除 BitsTransfer 模組。

參數

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-Force

表示此 Cmdlet 會移除唯讀模組。 根據預設，Remove-Module 只會移除讀寫模組。

ReadOnly 和 ReadWrite 值會儲存在模組的 accessMode 属性 。

類型:SwitchParameter
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-FullyQualifiedName

指定要移除之模組的完整名稱。

類型:ModuleSpecification[]
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-ModuleInfo

指定要移除的模組物件。 輸入包含模組物件的變數（PSModuleInfo）或取得模組物件的命令，例如 Get-Module 命令。 您也可以使用管線將模組物件傳送至 Remove-Module。

類型:PSModuleInfo[]
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Name

指定要移除的模組名稱。 允許通配符。 您也可以使用管線將名稱字串傳送至 Remove-Module。

類型:String[]
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:True

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

類型:SwitchParameter
別名:wi
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

System.String, System.Management.Automation.PSModuleInfo

您可以使用管線將模組名稱和模組物件傳送至 Remove-Module。

輸出

None

此 Cmdlet 不會產生任何輸出。