Сведения о PSSnapins

Статья
05/09/2024

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

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

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

Оснастка Windows PowerShell — это сборка платформа .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.

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

Чтобы получить список оснастки 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.

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

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, который всегда отображается как оснастка. Оснастка "Ядро" включена в каждый сеанс по умолчанию. Встроенные модули загружаются автоматически при первом использовании.

ПРИМЕЧАНИЕ. Удаленные сеансы, включая сеансы, запущенные с помощью командлета New-PSSession, — это сеансы старого стиля, в которых встроенные команды упаковываются в оснастки.

Следующие оснастки (или модули) устанавливаются с Windows PowerShell.

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