Add-PSSnapin
Добавляет в текущий сеанс одну или несколько оснасток Windows PowerShell.
Синтаксис
Add-PSSnapin
[-Name] <String[]>
[-PassThru]
[<CommonParameters>]
Описание
Командлет Add-PSSnapin
добавляет зарегистрированные оснастки Windows PowerShell в текущий сеанс. После добавления оснастки можно использовать в текущем сеансе командлеты и поставщиков, поддерживающих оснастки.
Чтобы добавить оснастку во все будущие сеансы Windows PowerShell, добавьте Add-PSSnapin
команду в профиль Windows PowerShell. Дополнительные сведения см. в разделе about_Profiles.
Начиная с Windows PowerShell 3.0, основные команды, включенные в Windows PowerShell, упаковываются в модули. Исключением является Microsoft.PowerShell.Core, который является оснасткой (PSSnapin). По умолчанию в сеанс добавляется только оснастка Microsoft.PowerShell.Core . Модули импортируются автоматически при первом использовании и можно использовать командлет Import-Module для их импорта.
Примеры
Пример 1. Добавление оснастки
PS C:\> Add-PSSnapIn -Name Microsoft.Exchange, Microsoft.Windows.AD
Эта команда добавляет оснастки Microsoft Exchange и Active Directory в текущий сеанс.
Пример 2. Добавление всех зарегистрированных оснастки
PS C:\> Get-PSSnapin -Registered | Add-PSSnapin -Passthru
Эта команда добавляет в сеанс все зарегистрированные оснастки Windows PowerShell. Он использует командлет Get-PSSnapin с зарегистрированным параметром для получения объектов, представляющих каждую зарегистрированную оснастку. Оператор конвейера (|) передает результатAdd-PSSnapin
, который добавляет их в сеанс. Параметр PassThru возвращает объекты, представляющие каждый из добавленных оснастки.
Пример 3. Регистрация оснастки и его добавление
Первая команда получает оснастки, добавленные в текущий сеанс, который включает оснастки, установленные с Windows PowerShell. В этом примере ManagementFeatures не возвращается. Это означает, что он не был добавлен в сеанс.
Вторая команда получает оснастки, зарегистрированные в вашей системе, которая включает те, которые уже были добавлены в сеанс. Он не включает оснастки, установленные с Помощью Windows PowerShell. В этом случае команда не возвращает оснастки. Это означает, что оснастка ManagementFeatures не зарегистрирована в системе.
Третья команда создает псевдоним, installutil для пути средства InstallUtil в платформа .NET Framework.
Четвертая команда использует средство InstallUtil для регистрации оснастки. Команда указывает путь к ManagementCmdlets.dll, имени файла или модуля оснастки.
Пятая команда совпадает со второй командой. На этот раз вы используете его для проверки регистрации оснастки ManagementCmdlets.
Шестая команда использует Add-PSSnapin
командлет для добавления оснастки ManagementFeatures в сеанс. Он задает имя оснастки, ManagementFeatures, а не имя файла.
Чтобы убедиться, что оснастка добавлена в сеанс, седьмая команда использует параметр модуля командлета Get-Command. В нем отображаются элементы, которые были добавлены в сеанс оснасткой или модулем.
Вы также можете использовать свойство PSSnapin объекта, возвращаемого Get-Command
командлетом, чтобы найти оснастку или модуль, в котором был создан командлет. Восьмая команда использует нотацию точек для поиска значения свойства PSSnapin командлета Set-Alias.
PS C:\> Get-PSSnapin
PS C:\> Get-PSSnapin -Registered
PS C:\> Set-Alias installutil $env:windir\Microsoft.NET\Framework\v2.0.50727\installutil.exe
PS C:\> installutil C:\Dev\Management\ManagementCmdlets.dll
PS C:\> Get-PSSnapin -Registered
PS C:\> add-pssnapin ManagementFeatures
PS C:\> Get-Command -Module ManagementFeatures
PS C:\> (Get-Command Set-Alias).pssnapin
В этом примере показан процесс регистрации оснастки в системе и последующее добавление этой оснастки в сеанс. В нем используется ManagementFeatures, вымышленная оснастка, реализованная в файле с именем ManagementCmdlets.dll.
Параметры
-Name
Указывает имя оснастки. Это имя, а не имя сборки или имя модуля. Разрешено использовать подстановочные знаки.
Чтобы найти имена зарегистрированных оснастки в системе, введите Get-PSSnapin -Registered
.
Тип: | String[] |
Position: | 0 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | True |
-PassThru
Указывает, что этот командлет возвращает объект, представляющий каждую добавленную оснастку. По умолчанию этот командлет не создает выходные данные.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Входные данные
None
Нельзя передать объекты в этот командлет с помощью конвейера.
Выходные данные
None or System.Management.Automation.PSSnapInInfo
Этот командлет возвращает объект PSSnapInInfo, представляющий оснастку, если указать параметр PassThru . В противном случае командлет не формирует никаких выходных данных.
Примечания
Windows PowerShell включает следующие псевдонимы для Add-PSSnapin
:
asnp
Начиная с Windows PowerShell 3.0, основные команды, включенные в Windows PowerShell, упаковываются в модули. В Windows PowerShell 2.0 и в ведущих программах, которые создают сеансы более старых стилей в более поздних версиях Windows PowerShell, основные команды упаковываются в оснастки (PSSnapins). Исключением является Microsoft.PowerShell.Core, который всегда является оснасткой. Кроме того, удаленные сеансы, такие как запущенные командлетом New-PSSession, являются более старыми сеансами, включающими основные оснастки.
Сведения о методе CreateDefault2 , который создает сеансы с новым стилем с основными модулями, см. в статье CreateDefault2 Method.
Дополнительные сведения о оснастки см. в about_PSSnapins и создании оснастки Windows PowerShell.
Add-PSSnapin
добавляет оснастку только в текущий сеанс. Чтобы оснастка добавлялась во все сеансы Windows PowerShell, вставьте эту команду в профиль Windows PowerShell. Дополнительные сведения см. в разделе about_Profiles.
Вы можете добавить любую оснастку, зарегистрированную с помощью программы установки Microsoft платформа .NET Framework. Дополнительные сведения см. в разделе "Регистрация командлетов, поставщиков и ведущих приложений".
Чтобы получить список оснастки, зарегистрированных на компьютере, введите Get-PSSnapin -Registered
.
Перед добавлением оснастки проверьте версию оснастки, чтобы убедиться, Add-PSSnapin
что она совместима с текущей версией Windows PowerShell. Если оснастка не проходит проверку версии, Windows PowerShell сообщает об ошибке.
Связанные ссылки
PowerShell