Поделиться через


Remove-PSSnapin

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

Синтаксис

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

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

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Name

Задает имена оснасток Windows PowerShell для удаления из текущего сеанса. Разрешены подстановочные знаки (*).

Тип:String[]
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-PassThru

Возвращает объект, представляющий оснастку. По умолчанию этот командлет не создает выходные данные.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

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

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инструкции.