現在のセッションからモジュールを削除します。

構文

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

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

説明

Remove-Module コマンドレットは、現在のセッションからモジュールのメンバーを削除します。

モジュールにアセンブリ (.dll) が含まれる場合、アセンブリによって実装されたすべてのメンバーが削除されますが、アセンブリ自体はアンロードされません。

パラメーター

-Force

アクセス モードが読み取り専用であるモジュールも削除します。

必須

false

位置

named

既定値

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-ModuleInfo <PSModuleInfo[]>

削除するモジュール オブジェクトを指定します。モジュール オブジェクト (PSModuleInfo) を格納する変数を入力するか、Get-Module コマンドなど、モジュール オブジェクトを取得するコマンドを入力します。パイプを使用してモジュール オブジェクトを Remove-Module に渡すこともできます。

必須

true

位置

1

既定値

パイプライン入力を許可する

true (ByValue)

ワイルドカード文字を許可する

false

-Name <string[]>

削除するモジュールの名前を指定します。ワイルドカードを使用できます。パイプを使用して名前文字列を Remove-Module に渡すこともできます。

必須

true

位置

1

既定値

パイプライン入力を許可する

true (ByValue)

ワイルドカード文字を許可する

true

-確認

コマンドを実行する前に確認メッセージを表示します。

必須

false

位置

named

既定値

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-WhatIf

実際にコマンドを実行せずに、コマンドを実行すると何が起きるかを出力します。

必須

false

位置

named

既定値

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

<CommonParameters>

このコマンドレットは、次の共通パラメーターをサポートします: -Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、および -OutVariable。Ô”¼š¤Ë¤Ä¤¤¤Æ¤Ï¡¢次を参照してください: about_Commonparameters.

入力と出力

入力値の型は、コマンドレットへのパイプが可能なオブジェクトの型です。戻り値の型は、コマンドレットによって返されるオブジェクトの型です。

入力

System.String、System.Management.Automation.PSModuleInfo

パイプを使用してモジュール名 (文字列) およびモジュール オブジェクトを Remove-Module に渡すことができます。

出力

None

Remove-Module は出力を生成しません。

Remove-Module をエイリアス "rmo" で参照することもできます。詳細については、「about_Aliases」を参照してください。

例 1

C:\PS>remove-module -name BitsTransfer

説明
-----------
このコマンドは、BitsTransfer モジュールを現在のセッションから削除します。






例 2

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

説明
-----------
このコマンドは、すべてのモジュールを現在のセッションから削除します。






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

説明
-----------
このコマンドは、FileTransfer モジュールおよび PSDiagnostics モジュールを現在のセッションから削除します。

このコマンドは、パイプライン演算子 (|) を使用してモジュール名を Remove-Module に送信します。Verbose 共通パラメーターを使用して、削除されるメンバーに関する詳細な情報を取得します。

Verbose メッセージには、削除される項目が表示されます。BitsTransfer モジュールにはコマンドレットを実装するアセンブリ、および独自のアセンブリを持つ入れ子のモジュールが含まれるため、表示されるメッセージは場合によって異なります。PSDiagnostics モジュールには、関数をエクスポートするモジュール スクリプト ファイル (.psm1) が含まれます。






例 4

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

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

説明
-----------
このコマンドは、ModuleInfo パラメーターを使用して BitsTransfer モジュールを削除します。






関連項目




目次