Удаляет оснастки 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", однако имя параметра можно опустить, поскольку оно является необязательным.

Remove-PSSnapin