about_PSSnapins

Краткое описание

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

Подробное описание

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

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

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

Начиная с Windows PowerShell 3.0 командлеты, которые отправляются с Помощью PowerShell, упаковываются в модули. Исключением является Microsoft.PowerShell.Core, который является единственным оставшимся оснасткой. Оснастка Microsoft.PowerShell.Core загружается в каждом сеансе по умолчанию. Остальные модули загружаются автоматически при первом использовании. Дополнительные сведения см. в about_Modules.

Поиск оснастки

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

Get-PSSnapin

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

Get-PSProvider | Format-List name, pssnapin

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

Get-PSSnapin -registered

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

Get-Command -Module <snap-in_name>

Установка оснастки

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

Добавление оснастки в текущий сеанс

Чтобы добавить зарегистрированную оснастку в текущий сеанс, используйте 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

Дополнительные сведения см. в статье "Экспорт консоли".

Открытие 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 3.0, можно записывать события выполнения для командлетов в модулях Windows PowerShell и оснастки, задав для свойства LogPipelineExecutionDetails модули и оснастки $trueв значение . Дополнительные сведения см. в about_EventLogs.

См. также