Удаляет модули из текущего сеанса.
Синтаксис
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.
См. также