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
В этот командлет нельзя передать входные данные.
Выходные данные
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.
Связанные ссылки
PowerShell