about_PSSnapins

Назначение: Windows PowerShell 2.0, Windows PowerShell 3.0, Windows PowerShell 4.0, Windows PowerShell 5.0

РАЗДЕЛ

about_PSSnapins

КРАТКОЕ ОПИСАНИЕ

Содержит описание оснасток Windows PowerShell и сведения об использовании оснасток и управлении ими.

ПОДРОБНОЕ ОПИСАНИЕ

Оснастка Windows PowerShell — это сборка Microsoft .NET Framework, в которой содержатся поставщики и/или командлеты Windows PowerShell. Среда Windows PowerShell включает набор базовых оснасток. Однако функциональность Windows PowerShell можно расширить, добавив оснастки с поставщиками и командлетами, созданными вами или полученными от других разработчиков.

После добавления оснастки содержащиеся в ней командлеты и поставщики мгновенно становятся доступными для использования в текущем сеансе; при этом изменение касается только текущего сеанса.

Чтобы можно было добавить оснастку во все будущие сеансы, сохраните ее в своем профиле Windows PowerShell. Кроме того, можно использовать командлет Export-Console для сохранения имен оснасток в файле консоли и применения его в будущих сеансах. Можно даже сохранить несколько файлов консоли, включающих различные наборы оснасток.

Примечание

Оснастки Windows PowerShell (PSSnapins) доступны для использования в Windows PowerShell 3.0 и Windows PowerShell 2.0. В последующих версиях они могут быть изменены или недоступны. Для упаковки командлетов и поставщиков Windows PowerShell используйте модули. Сведения о создании модулей и преобразовании оснасток в модули см. в разделе «Написание модуля Windows PowerShell» в библиотеке MSDN по адресу https://go.microsoft.com/fwlink/?LinkID=141556.

ПОИСК ОСНАСТОК

Чтобы получить список имеющихся на компьютере оснасток Windows PowerShell, введите следующую команду:

       get-pssnapin

Чтобы получить оснастку для каждого поставщика Windows PowerShell, введите следующую команду:

        get-psprovider | format-list name, pssnapin

Чтобы получить список командлетов, содержащихся в оснастке Windows PowerShell, введите следующую команду:

        get-command -module <snap-in_name>

УСТАНОВКА ОСНАСТКИ

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

РЕГИСТРАЦИЯ ОСНАСТКИ

Оснастка Windows PowerShell — это программа, написанная на языке .NET Framework и скомпилированная в DLL-файл. Для использования поставщиков и командлетов, содержащихся в оснастке, ее нужно зарегистрировать (добавить в реестр).

Большинство оснасток поставляется с программой установки (EXE- или MSI-файл), которая регистрирует DLL-файл. Однако оснастку, полученную в виде DLL-файла, также можно зарегистрировать в системе. Дополнительные сведения см. в разделе «Регистрация командлетов, поставщиков и хост-приложений» в библиотеке MSDN (Microsoft Developer Network) по адресу https://go.microsoft.com/fwlink/?LinkID=143619.

Чтобы получить список всех зарегистрированных в системе оснасток или проверить, зарегистрирована ли оснастка, введите следующую команду:

       get-pssnapin -registered

ДОБАВЛЕНИЕ ОСНАСТКИ В ТЕКУЩИЙ СЕАНС

Для добавления зарегистрированных оснасток в текущий сеанс используйте командлет Add-PsSnapin. Например, чтобы добавить в сеанс оснастку Microsoft SQL Server, введите следующую команду:

       add-pssnapin sql

После выполнения этой команды поставщики и командлеты, содержащиеся в оснастке, будут доступны в сеансе. Однако они будут доступны только в текущем сеансе. Чтобы сделать их доступными в других сеансах, их нужно сохранить.

СОХРАНЕНИЕ ОСНАСТОК

Для использования оснастки в будущих сеансах Windows PowerShell добавьте команду Add-PsSnapin в профиль Windows PowerShell или экспортируйте имена оснасток в файл консоли.

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

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

Для сохранения оснасток из сеанса в файл консоли (PSC1) используйте командлет Export-Console. Например, для сохранения оснасток в конфигурации текущего сеанса в файле NewConsole.psc1 в текущем каталоге введите следующую команду:

Вставьте сюда основной текст раздела.

       export-console NewConsole

Подробнее см. в описании командлета Export-Console.

ЗАПУСК WINDOWS POWERSHELL С ФАЙЛОМ КОНСОЛИ

Для использования файла консоли, включающего оснастку, запустите Windows PowerShell (PowerShell.exe) из командной строки в сеансе Cmd.exe или в другом сеансе Windows PowerShell. Используйте параметр PsConsoleFile для указания файла консоли, который включает оснастку. Например, следующая команда запускает Windows PowerShell с файлом консоли NewConsole.psc1:

       PowerShell.exe -psconsolefile NewConsole.psc1

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

УДАЛЕНИЕ ОСНАСТКИ

Для удаления оснастки Windows PowerShell из текущего сеанса используйте командлет Remove-PsSnapin. Например, чтобы удалить оснастку SQL Server из текущего сеанса, введите следующую команду: Вставить здесь текст раздела

       remove-pssnapin sql

Этот командлет удаляет оснастку из сеанса. Оснастка остается загруженной, но поддерживаемые ею поставщики и командлеты становятся недоступными.

ВСТРОЕННЫЕ КОМАНДЫ

В Windows PowerShell 2.0 и основных программах старого стиля в Windows PowerShell 3.0 и более поздних версий встроенные команды, которые устанавливаются вместе с Windows PowerShell, упакованы в оснастки, которые автоматически добавляются в каждый сеанс Windows PowerShell.

Начиная с версии Windows PowerShell 3.0 в основных программах нового стиля, которые запускают сеансы с помощью метода InitialSessionState.CreateDefault2, встроенные команды упакованы в модули. Исключением является модуль Microsoft.PowerShell.Core, который всегда является оснасткой. Оснастка Core добавляется в каждый сеанс по умолчанию. Встроенные модули загружаются автоматически при первом использовании.

Примечание

Удаленные сеансы, включая сеансы, которые запускаются с помощью командлета New-PSSession, представляют собой сеансы старого стиля, где встроенные команды упакованы в оснастки.

  • Microsoft.PowerShell.Core
    Содержит поставщики и командлеты, используемые для управления базовыми функциями Windows PowerShell. Включает поставщики FileSystem, Registry, Alias, Environment, Function и Variable, а также базовые командлеты, такие как Get-Help, Get-Command и Get-History.
  • Microsoft.PowerShell.Host
    Содержит командлеты, используемые главным приложением Windows PowerShell, такие как Start-Transcript и Stop-Transcript.
  • Microsoft.PowerShell.Management
    Содержит такие командлеты, как Get-Service и Get-ChildItem, которые используются для управления функциями на основе Windows.
  • Microsoft.PowerShell.Security
    Содержит поставщик Certificate и командлеты, используемые для управления системой безопасности Windows PowerShell, такие как Get-Acl, Get-AuthenticodeSignature и ConvertTo-SecureString.
  • Microsoft.PowerShell.Utility
    Содержит командлеты, используемые для работы с объектами и данными, такие как Get-Member, Write-Host и Format-List.
  • Microsoft.WSMan.Management
    Содержит поставщик WSMan и командлеты, которые управляют службой удаленного управления Windows, такие как Connect-WSMan и Enable-WSManCredSSP.

ВЕДЕНИЕ ЖУРНАЛА СОБЫТИЙ ОСНАСТОК

Начиная с Windows PowerShell 3.0 можно записывать события выполнения командлетов в модулях и оснастках Windows PowerShell, присвоив свойству LogPipelineExecutionDetails модулей и оснасток значение TRUE. Подробнее см. в разделе about_EventLogs (https://go.microsoft.com/fwlink/?LinkID=113224).

СМ. ТАКЖЕ

Add-PsSnapin

Get-PsSnapin

Remove-PsSnapin

Export-Console

Get-Command

about_Profiles

about_Modules

КЛЮЧЕВЫЕ СЛОВА: about_Snapins, about_Snap_ins, about_Snap-ins