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