Добавляет одну или несколько оснасток Windows PowerShell в текущий сеанс.

Синтаксис

Add-PSSnapin [-Name] <string[]> [-PassThru] [<CommonParameters>]

Описание

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

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

Параметры

-Name <string[]>

Задает имя оснастки. (Это параметр Name, его не следует путать с параметром AssemblyName или ModuleName.)

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

Обязательно?

true

Позиция?

1

Значение по умолчанию

Принимать входные данные из конвейера?

true (ByPropertyName)

Принимать подстановочные знаки?

false

-PassThru

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

Обязательно?

false

Позиция?

named

Значение по умолчанию

Принимать входные данные из конвейера?

false

Принимать подстановочные знаки?

false

<CommonParameters>

Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.

Ввод и вывод

Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.

Входные данные

None

Объекты невозможно передать командлету Add-PSSnapin по конвейеру.

Выходные данные

Нет или System.Management.Automation.PSSnapInInfo

При использовании параметра PassThru командлет Add-PSSnapin возвращает объект PSSnapInInfo, представляющий оснастку. В противном случае этот командлет не формирует никаких выходных данных.

Примечания

Чтобы получить дополнительные сведения об оснастках Windows PowerShell, см. раздел about_Pssnapins. Сведения о создании оснастки Windows PowerShell см. в разделе "Как создать оснастку Windows PowerShell" в библиотеке MSDN (Microsoft Developer Network) по адресу https://go.microsoft.com/fwlink/?LinkId=144762.

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

Может быть добавлена любая оснастка Windows PowerShell, зарегистрированная при помощи программы установки Microsoft .NET Framework. Дополнительные сведения см. в разделе "Регистрация командлетов, поставщиков и ведущих приложений" библиотеки MSDN по адресу https://go.microsoft.com/fwlink/?LinkID=143619.

Для получения списка оснасток, зарегистрированных на компьютере, введите команду "Get-PSSnapin -registered".

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

Пример 1

C:\PS>add-PSSnapIn Microsoft.Exchange, Microsoft.Windows.AD

Описание
-----------
Эта команда добавляет оснастки Microsoft Exchange и Active Directory в текущий сеанс.

Пример 2

C:\PS>get-pssnapin -registered | add-pssnapin -passthru

Описание
-----------
Эта команда добавляет в сеанс все зарегистрированные оснастки Windows PowerShell. В ней используется командлет Get-PSSnapin с параметром Registered для получения объектов, представляющих каждую из зарегистрированных оснасток. Оператор конвейера (|) передает результат командлету Add-PSSnapin, который добавляет их в сеанс. Параметр PassThru возвращает объекты, представляющие каждую из добавленных оснасток.

Пример 3

C:\PS>get-pssnapin

Описание
-----------
В этом примере демонстрируется процесс регистрации оснастки в вашей системе и добавления оснастки в текущий сеанс. В примере используется ManagementFeatures, фиктивная оснастка, которая реализована в файле ManagementCmdlets.dll.

Первая команда возвращает оснастки, добавленные в текущий сеанс, включая оснастки, которые установлены с Windows PowerShell. В этом примере ManagementFeatures не возвращается. Это означает, что данная оснастка не была добавлена в сеанс. 

    get-pssnapin


Вторая команда возвращает оснастки, которые были зарегистрированы в системе (включая те оснастки, которые уже добавлены в сеанс). Оснастки, установленные с Windows PowerShell, не включаются в этот список.

    get-pssnapin -registered

 
В данном случае команда не возвращает никаких оснасток. Такой результат указывает на то, что оснастка ManagementFeatures не зарегистрирована в системе.

Третья команда создает псевдоним Installutil для пути к средству InstallUtil, входящего в состав платформы .NET Framework.

    set-alias installutil $env:windir\Microsoft.NET\Framework\v2.0.50727\installutil.exe


Четвертая команда использует средство InstallUtil для регистрации оснастки. В команде указывается путь к файлу ManagementCmdlets.dll, имя файла или "имя модуля" оснастки.

    installutil C:\Dev\Management\ManagementCmdlets.dll


Пятая команда совпадает со второй. Необходимо убедиться, что регистрация оснастки ManagementCmdlets прошла успешно.

    get-pssnapin -registered

Шестая команда использует командлет Add-PSSnapin для добавления оснастки ManagementFeatures в сеанс. В этой команде указывается имя оснастки (ManagementFeatures), а не имя файла.

    add-pssnapin ManagementFeatures

Чтобы убедиться, что оснастка добавлена в сеанс, в седьмой команде используется параметр Module командлета Get-Command. Этот параметр позволяет вернуть элементы, добавленные в сеанс, по оснастке или модулю. 

    get-command -module ManagementFeatures

Чтобы определить оснастку или модуль, из которой был вызван командлет, можно также использовать свойство PSSnapin объекта, возвращаемого командлетом Get-Command. В восьмой команде для определения значения свойства PSSnapin команды Set-Alias используется обращение к элементам объекта с помощью точки. 

    (get-command set-alias).pssnapin

См. также



Содержание