Удаляет модули из текущего сеанса.

Синтаксис

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

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

Описание

Командлет Remove-Module удаляет члены модуля из текущего сеанса.

Если модуль содержит сборку (DLL), все члены, реализованные в сборке, удаляются, но сборка не выгружается.

Параметры

-Force

Удаляет модули, даже если свойство AccessMode имеет значение ReadOnly.

Обязательно?

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

-Confirm

Запрашивает подтверждение перед выполнением команды.

Обязательно?

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 по конвейеру.

Выходные данные

Нет

Командлет 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 используется для получения подробной информации об удаляемых членах.

Подробные сообщения описывают удаляемые элементы. Эти сообщения различаются, поскольку модуль BitsTransfer включает сборку, реализующие его командлеты, и вложенный модуль с собственной сборкой. Модуль PSDiagnostics включает файл скрипта модуля (PSM1), который экспортирует функции.






Пример 4

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

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

Описание
-----------
Эта команда удаляет модуль BitsTransfer с использованием параметра ModuleInfo.






См. также




Содержание