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


Get-PSSnapin

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

Синтаксис

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

Описание

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

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

Начиная с 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 или библиотеками динамической компоновки (библиотеками DLL) оснасток Windows PowerShell, которые еще не зарегистрированы в системе.

Пример 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 включает следующие псевдонимы для Get-PSSnapin:

  • gsnp

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

Сведения о методе CreateDefault2 , который создает сеансы с новым стилем с основными модулями, см. в статье CreateDefault2 Method.