Remove-PSSnapin
Удаляет оснастки Windows PowerShell из текущего сеанса.
Синтаксис
Default (По умолчанию)
Remove-PSSnapin
[-Name] <String[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет Remove-PSSnapin удаляет оснастку Windows PowerShell из текущего сеанса. Его можно использовать для удаления оснастки, добавленных в Windows PowerShell, нельзя использовать этот командлет для удаления оснастки, установленных с Помощью Windows PowerShell.
После удаления оснастки из текущего сеанса оснастка по-прежнему загружается, но командлеты и поставщики в оснастке больше не доступны в сеансе.
Примеры
Пример 1. Удаление оснастки
Remove-PSSnapin -Name Microsoft.Exchange
Эта команда удаляет оснастки Microsoft.Exchange
Пример 2. Удаление оснастки с помощью имен с конвейером
Get-PSSnapin smp* | Remove-PSSnapin
Эта команда удаляет оснастки Windows PowerShell с именами, начинающимися с SMP из текущего сеанса.
Команда использует командлет Get-PSSnapin для получения объектов, представляющих оснастки. Оператор конвейера (|) отправляет результаты в командлет Remove-PSSnapin, который удаляет их из сеанса. Поставщики и командлеты, поддерживаемые этой оснасткой, больше не доступны в сеансе.
При канале объектов в Remove-PSSnapinимена объектов связаны с параметром Name, который принимает объекты из конвейера с свойством Name.
Пример 3. Удаление оснастки с помощью имен
Remove-PSSnapin -Name *event*
Эта команда удаляет все оснастки Windows PowerShell с именами, включающими событие.
Параметры
-Confirm
Запрашивает подтверждение перед запуском cmdlet.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Name
Указывает имена оснастки Windows PowerShell для удаления из текущего сеанса.
Разрешены подстановочные символы (*).
Свойства параметров
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-PassThru
Возвращает объект, представляющий оснастку. По умолчанию этот командлет не создает выходные данные.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Входные данные
PSSnapInInfo
Вы можете передать объект оснастки в этот командлет.
Выходные данные
None, System.Management.Automation.PSSnapInInfo
Этот командлет создает объект System.Management.Automation.PSSnapInInfo, представляющий оснастку, если указать параметр PassThru. По умолчанию Remove-PSSnapin не создает выходные данные.
Примечания
Windows PowerShell включает следующие псевдонимы для Remove-PSSnapin:
rsnp
Remove-PSSnapin не проверяет версию Windows PowerShell перед удалением оснастки из сеанса. Если оснастка не удается удалить, появится предупреждение, и команда завершается ошибкой.
Remove-PSSnapin влияет только на текущий сеанс. Если вы добавили команду Add-PSSnapin в профиль Windows PowerShell, удалите команду, чтобы удалить оснастку из будущих сеансов. Для инструкций введите Get-Help about_Profiles.
