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, а не имя файла.

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

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-PassThru

Указывает, что этот командлет возвращает объект, представляющий каждую добавленную оснастку. По умолчанию этот командлет не создает выходные данные.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 сообщает об ошибке.