Удаляет оснастки Windows PowerShell из текущего сеанса.
Синтаксис
Remove-PSSnapin [-Name] <string[]> [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
Описание
Командлет Remove-PSSnapin удаляет оснастку Windows PowerShell из текущего сеанса. Он используется для удаления оснасток, которые были добавлены в оболочку Windows PowerShell, но его нельзя использовать для удаления оснасток, установленных вместе с Windows PowerShell.
После удаления оснастки из текущего сеанса она остается загруженной, однако командлеты и поставщики оснастки будут недоступны в данном сеансе.
Параметры
-Name <string[]>
Задает имена оснасток Windows PowerShell, которые требуется удалить из текущего сеанса. Имя параметра ("Name") указывать необязательно. В значении разрешается использовать подстановочные знаки (*).
|
Обязательно? |
true |
|
Позиция? |
1 |
|
Значение по умолчанию |
нет |
|
Принимать входные данные из конвейера? |
true (ByPropertyName) |
|
Принимать подстановочные знаки? |
true |
-PassThru
Возвращает объект, представляющий оснастку. По умолчанию этот командлет не формирует никаких выходных данных.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Confirm
Запрашивает подтверждение перед выполнением команды.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-WhatIf
Описывает, что произойдет при выполнении команды, без ее фактического выполнения.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
<CommonParameters>
Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.
Ввод и вывод
Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.
|
Входные данные |
System.Management.Automation.PSSnapInInfo Можно передать объект оснастки командлету Remove-PSSnapin по конвейеру. |
|
Выходные данные |
Нет или System.Management.Automation.PSSnapInInfo По умолчанию командлет Remove-PsSnapin не формирует никаких выходных данных. При использовании параметра PassThru командлет создает объект System.Management.Automation.PSSnapInInfo, представляющий оснастку. |
Примечания
Командлет Remove-PSSnapin также можно вызывать с помощью встроенного псевдонима "rsnp". Дополнительные сведения см. в разделе about_Aliases.
Командлет Remove-PSSnapin не проверяет версию Windows PowerShell перед удалением оснастки из сеанса. Если оснастка не может быть удалена, отображается предупреждение, и команда завершается с ошибкой.
Командлет Remove-PSSnapin влияет только на текущий сеанс. Если в профиль Windows PowerShell добавлена команда Add-PSSnapin, для удаления оснастки из будущих сеансов эту команду следует удалить. Инструкции см. в разделе about_Profiles.
Пример 1
C:\PS>remove-pssnapin -name Microsoft.Exchange Описание ----------- Эта команда удаляет из текущего сеанса оснастку Microsoft.Exchange. После выполнения команды командлеты и поставщики, поддерживаемые этой оснасткой, будут недоступны в этом сеансе.
Пример 2
C:\PS>get-PSSnapIn smp* | remove-PSSnapIn Описание ----------- Эта команда удаляет из текущего сеанса оснастки Windows PowerShell, имена которых начинаются с "smp". С помощью командлета Get-PSSnapin команда получает объекты, представляющие оснастки. Оператор конвейера (|) передает результаты командлету Remove-PSSnapin, который удаляет их из сеанса. Поддерживаемые оснасткой поставщики и командлеты более не доступны в сеансе. При передаче объектов командлету Remove-PSSnapin по конвейеру имена объектов связываются с параметром Name, который принимает по конвейеру объекты, содержащие свойство Name.
Пример 3
C:\PS>remove-pssnapin -name *event* Описание ----------- Эта команда удаляет все оснастки Windows PowerShell, в именах которых содержится слово "event". В этой команде используется имя параметра "Name", однако имя параметра можно опустить, поскольку оно является необязательным.
См. также