Get-PSSnapin
Получает оснастки Windows PowerShell на компьютере.
Синтаксис
Default (По умолчанию)
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 или оснастки Windows PowerShell в библиотеках динамических ссылок (DLL), которые еще не зарегистрированы в системе.
Пример 3. Получение текущих оснастки, которые соответствуют строке
PS C:\> Get-PSSnapin -Name smp*
Эта команда получает оснастки Windows PowerShell в текущем сеансе с именами, начинающимися с SMP.
Параметры
-Name
Задает массив имен оснастки. Этот командлет получает только указанные оснастки Windows PowerShell. Разрешены подстановочные знаки.
Свойства параметров
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 0 |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Registered
Указывает, что этот командлет получает оснастки Windows PowerShell, зарегистрированные в системе, даже если они еще не добавлены в сеанс.
Оснастки, установленные с Windows PowerShell, не отображаются в этом списке.
Без этого параметра Get-PSSnapin получает оснастки Windows PowerShell, добавленные в сеанс.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Входные данные
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.
