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

Add-PSSnapin

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

Добавляет одну или несколько оснастки 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, а не имя файла.

Чтобы убедиться, что оснастка добавлена в сеанс, седьмая команда использует параметр module командлета 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.

Дополнительные сведения о оснастки см. в about_PSSnapins и создании оснастки Windows PowerShell.

Add-PSSnapin добавляет оснастку только в текущий сеанс. Чтобы добавить оснастку ко всем сеансам Windows PowerShell, добавьте его в профиль Windows PowerShell. Дополнительные сведения см. в about_Profiles.

Вы можете добавить любую оснастку, зарегистрированную с помощью программы установки Microsoft .NET Framework. Дополнительные сведения см. в разделе Регистрация командлетов, поставщиков иведущих приложений.

Чтобы получить список оснастки, зарегистрированных на компьютере, введите Get-PSSnapin -Registered.

Перед добавлением оснастки Add-PSSnapin проверяет версию оснастки, чтобы убедиться, что она совместима с текущей версией Windows PowerShell. Если оснастка завершается ошибкой проверки версии, Windows PowerShell сообщает об ошибке.