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

Get-PSSnapin

  • Ссылка
Модуль:
Microsoft.PowerShell.Core

Получает оснастки Windows PowerShell на компьютере.

Синтаксис

Get-PSSnapin
   [[-Name] <String[]>]
   [-Registered]
   [<CommonParameters>]

Описание

Командлет Get-PSSnapin получает оснастки Windows PowerShell, добавленные в текущий сеанс или зарегистрированные в системе. Этот командлет содержит оснастки в порядке их обнаружения.

Get-PSSnapin получает только зарегистрированные оснастки. Чтобы зарегистрировать оснастку Windows PowerShell, используйте средство InstallUtil, включенное в Microsoft .NET Framework 2.0. Дополнительные сведения см. в разделе Регистрация командлетов, поставщиков и ведущих приложений в библиотеке MSDN.

Начиная с Windows PowerShell 3.0 основные команды, включенные в Windows PowerShell, упаковываются в модули. Исключением является Microsoft.PowerShell.Core, которая является оснасткой (PSSnapin). По умолчанию в сеанс добавляется только оснастка Microsoft.PowerShell.Core . Модули импортируются автоматически при первом использовании и можно использовать командлет Import-Module для их импорта.

Примеры

Пример 1. Получение оснастки, загруженных в данный момент

PS C:\> Get-PSSnapIn

Эта команда получает оснастки Windows PowerShell, загруженные в данный момент в сеансе. К ним относятся оснастки, установленные с Windows PowerShell, и те, которые были добавлены в сеанс.

Пример 2. Получение оснастки, зарегистрированных

PS C:\> get-PSSnapIn -Registered

Эта команда получает оснастки Windows PowerShell, зарегистрированные на компьютере, включая те, которые уже были добавлены в сеанс. Выходные данные не включают оснастки, установленные с помощью Оснастки Windows PowerShell или оснастки Windows PowerShell в библиотеках динамических ссылок (DLL), которые еще не зарегистрированы в системе.

Пример 3. Получение текущих оснастки, которые соответствуют строке

PS C:\> Get-PSSnapIn -Name smp*

Эта команда получает оснастки Windows PowerShell в текущем сеансе с именами, начинающимися с SMP.

Параметры

-Name

Задает массив имен оснастки. Этот командлет получает только указанные оснастки Windows PowerShell. Разрешены подстановочные знаки.

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

-Registered

Указывает, что этот командлет получает оснастки Windows PowerShell, зарегистрированные в системе, даже если они еще не добавлены в сеанс.

Оснастки, установленные с Windows PowerShell, не отображаются в этом списке.

Без этого параметра Get-PSSnapin получает оснастки Windows PowerShell, добавленные в сеанс.

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

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

None

Входные данные в этот командлет невозможно передать.

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

PSSnapInInfo

Get-PSSnapin возвращает объект для каждой оснастки, которую он получает.

Примечания

  • Начиная с Windows PowerShell 3.0 основные команды, установленные с Помощью Windows PowerShell, упаковываются в модули. В Windows PowerShell 2.0 и в ведущих программах, которые создают сеансы более старого стиля в более поздних версиях Windows PowerShell, основные команды упаковываются в оснастки (PSSnapin). Исключением является Microsoft.PowerShell.Core, которая всегда является оснасткой. Кроме того, удаленные сеансы, такие как запущенные командлетом New-PSSession, являются более старыми сеансами, включающими основные оснастки.

    Сведения о методе CreateDefault2, который создает сеансы нового стиля с основными модулями, см. в Метод CreateDefault2 в библиотеке MSDN.